Get Workspace Users

GET

/v1/workspaces/users

Lists every "user" associated with a workspace — but this is broader than it sounds: it returns team members in a single mixed list.

Behavior:

Fetches workspace-user membership records only — Pending (invited but not yet accepted) and Suspended members are silently excluded from this list.

For each active membership, maps to the response shape via the identity user record — email, localized name (ar/en via Accept-Language), avatar, and phone number.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Combined list of active human members and AI agents in the workspace.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/workspaces/users' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "id": "89c763...............",
    "workspaceId": "d307b8...............",
    "userId": "3a1dc2...............",
    "email": "noshy@hatif.io",
    "name": "نصحي",
    "logoUrl": "",
    "role": 1,
    "creationTime": "2025-11-23T09:48:09.943939",
    "isAiAgent": false,
    "phoneNumber": null
}

Modified at 2026-06-22 13:44:27

Delete Contact Property

Get Conversation Timeline