Skip to main content

Users API

Manage end-users associated with your workspaces.

Create User​

Create a new user in a specific workspace.

Request

curl -X POST "https://api.syauth.com/e/v1/developer/users/?workspace_id=78047707-5f8f-472b-a065-3d3dc48ba80a" \
  -H "X-Developer-Token: syat_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "SecurePassword123!",
    "first_name": "New",
    "last_name": "User"
  }'

Response

{
  "id": "5b3a2362-8e85-40cd-b9c5-a02edca86aa7",
  "email": "[email protected]",
  "first_name": "New",
  "last_name": "User",
  "email_verified": false,
  "created_at": "2026-01-07T10:10:00Z",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a"
}

List Users​

List all users across your workspaces.

Request

curl -X GET https://api.syauth.com/e/v1/developer/users/ \
  -H "X-Developer-Token: syat_..."

Response

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "5b3a2362-8e85-40cd-b9c5-a02edca86aa7",
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe",
      "email_verified": true,
      "created_at": "2026-01-01T22:20:00Z"
    },
    {
      "id": "...",
      "email": "[email protected]",
      "email_verified": false
    }
  ]
}

Get User Details​

Request

curl -X GET https://api.syauth.com/e/v1/developer/users/5b3a2362-8e85-40cd-b9c5-a02edca86aa7/ \
  -H "X-Developer-Token: syat_..."

Response

{
  "id": "5b3a2362-8e85-40cd-b9c5-a02edca86aa7",
  "email": "[email protected]",
  "first_name": "New",
  "last_name": "User",
  "email_verified": false,
  "created_at": "2026-01-07T10:10:00Z",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a"
}

Update User​

Update a specific user's details.

Request

curl -X PATCH https://api.syauth.com/e/v1/developer/users/5b3a2362-8e85-40cd-b9c5-a02edca86aa7/ \
  -H "X-Developer-Token: syat_..." \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Updated", "last_name": "Name"}'

Response

{
  "id": "5b3a2362-8e85-40cd-b9c5-a02edca86aa7",
  "email": "[email protected]",
  "first_name": "Updated",
  "last_name": "Name",
  "email_verified": false,
  "created_at": "2026-01-07T10:10:00Z",
  "workspace_id": "78047707-5f8f-472b-a065-3d3dc48ba80a"
}

Delete User​

Permanently delete a user.

Request

curl -X DELETE https://api.syauth.com/e/v1/developer/users/5b3a2362-8e85-40cd-b9c5-a02edca86aa7/ \
  -H "X-Developer-Token: syat_..."

Response 204 No Content