Get Member

Get one person or agent in your organisation, with their roles and teams.

GET /api/v1/users/{user_id}

cURL

curl "https://api.wordsmith.ai/api/v1/users/828b17cf-5f09-4edd-bcba-9d1de130a2e6" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "828b17cf-5f09-4edd-bcba-9d1de130a2e6",
  "name": "Priya Shah",
  "email": "[e-mail]",
  "kind": "human",
  "is_suspended": false,
  "predefined_roles": ["full_user"],
  "custom_role_ids": ["72f02d30-2d67-40b0-b5cb-859dbb45d485"],
  "team_ids": ["d38a34b1-d214-438b-96eb-03d864915478"]
}

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Returns one member: a person or an agent in your organisation. List Users returns the first five fields for everyone. This endpoint adds roles and teams.

predefined_roles holds the built-in roles (viewer, full_user, admin). custom_role_ids holds your organisation’s own roles; resolve their names with List Roles. team_ids lists the teams the member belongs to directly, among the teams the caller can see. It is empty when teams are not enabled for your organisation.

Authentication

Requires an API key, or an OAuth token with directory:read. The caller must also be allowed to see the members list in Settings.

Path parameters

user_id · string · required

The member’s id, from List Users.

Response

Returns 200 with the member. Suspended members are returned too, with is_suspended: true.

cURL

curl "https://api.wordsmith.ai/api/v1/users/828b17cf-5f09-4edd-bcba-9d1de130a2e6" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "828b17cf-5f09-4edd-bcba-9d1de130a2e6",
  "name": "Priya Shah",
  "email": "[e-mail]",
  "kind": "human",
  "is_suspended": false,
  "predefined_roles": ["full_user"],
  "custom_role_ids": ["72f02d30-2d67-40b0-b5cb-859dbb45d485"],
  "team_ids": ["d38a34b1-d214-438b-96eb-03d864915478"]
}

Errors

Status	error_code	When
403	insufficient_scope	The OAuth token does not hold directory:read.
404	resource_not_found	No member of your organisation has this id, or the caller cannot see the members list. Deleted members are not found.