Positions

Positions are the job titles configured for staff in your organisation (for example "Support Worker" or "Team Leader"). This is a small reference lookup, so the full set is returned in one response — there's no pagination. Requires the read:users scope.

GET/v1/positions

List positions

Returns every active position title in your organisation, ordered alphabetically. Requires the read:users scope.

Request

GET

/v1/positions

curl https://api.diversitysync.com/v1/positions \
  -H "Authorization: Bearer {access_token}"

Response

{
  "positions": [
    "Support Worker",
    "Team Leader",
    "House Manager"
  ]
}