Skip to main content
POST
/
api
/
v1
/
contacts
/
order
Reorder contacts
curl --request POST \
  --url https://api.contracting.kukkingu.software/api/v1/contacts/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'tenant-id: <tenant-id>' \
  --data '
{
  "clientId": "clnt_z2b3mo8qa5kzptgsu26q2wmh",
  "ids": [
    "con_123",
    "con_456",
    "con_789"
  ]
}
'
{
  "data": [
    "con_xlbg6ubfio7tzvsijyp5794c"
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

tenant-id
string
required

Specifies the tenant context for the request. All endpoints operate within this tenant scope.

Example:

"tnt_pfh0haxfpzowht3oi213cqos"

Body

application/json

Request body that defines the target order for contacts.

Request body that defines the target order for contacts.

clientId
string
required

Unique identifier of the client.

Example:

"clnt_z2b3mo8qa5kzptgsu26q2wmh"

ids
string[]
required

Ordered list of contact IDs representing the desired sort order.

The ID of the contact.

Example:
["con_123", "con_456", "con_789"]

Response

Default Response

Standard success response payload wrapped in a data property.

data
string[]
required

Ordered list of contact IDs after the reorder operation is applied.

The ID of the contact.