Skip to content
ShiftSync Developers

Respond to a friend request

Accepts or rejects a pending friend request identified by its invite code. Accepting returns the new friend; rejecting returns no item.

POST
/v1/friends/respond
curl --request POST \
  --url https://api.shiftsync.app/v1/friends/respond \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "accept", "inviteCode": "string" }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
status
required
string
Allowed values: accept reject
inviteCode
required
string
>= 1 characters
Example
{
  "status": "accept",
  "inviteCode": "string"
}

Responses

Section titled “Responses”

201

Section titled “201”

The new friend when accepted; no item when rejected

Media typeapplication/json
object
item
object
id
required
integer
>= -9007199254740991 <= 9007199254740991
emailAddress
required
string format: email
/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/
firstName
required
string
lastName
string
avatarUrls
object
small
required
string format: uri
medium
required
string format: uri
large
required
string format: uri
acceptedAt
required
string format: date-time
Example
{
  "item": {
    "id": 0,
    "emailAddress": "user@example.com",
    "firstName": "string",
    "lastName": "string",
    "avatarUrls": {
      "small": "https://example.com",
      "medium": "https://example.com",
      "large": "https://example.com"
    },
    "acceptedAt": "2026-01-01T09:00:00.000Z"
  }
}