Get Team

Get one team with its members and their team roles.

GET /api/v1/teams/{team_id}

cURL

curl "https://api.wordsmith.ai/api/v1/teams/26fb01d1-34cc-4ec6-9823-53fdeb24c86e" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "26fb01d1-34cc-4ec6-9823-53fdeb24c86e",
  "name": "Legal",
  "parent_team_id": null,
  "member_count": 3,
  "direct_member_count": 2,
  "member_ids": [
    "4c98ef69-d5ef-4471-a2b8-89ded5b7b121",
    "d850a4e0-5c88-4a9c-80da-640eefde1bcd",
    "828b17cf-5f09-4edd-bcba-9d1de130a2e6"
  ],
  "hidden": false,
  "membership_source": "manual",
  "members": [
    { "user_id": "4c98ef69-d5ef-4471-a2b8-89ded5b7b121", "role": "admin" },
    { "user_id": "d850a4e0-5c88-4a9c-80da-640eefde1bcd", "role": "member" }
  ]
}

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 team. List Teams returns the first six fields. This endpoint adds hidden, membership_source and members.

hidden is true when this team, or a team above it, is hidden from people who are not on it.

members lists the team’s direct members, each with a team role of admin or member. A team admin can rename the team and manage its members.

Teams nest. Anything shared with a team also reaches the members of every team beneath it. member_count counts that whole group, and direct_member_count counts only members. Sharing never flows upwards: a share with a sub-team does not reach its parent’s other members.

membership_source is manual or slack_channel. A slack_channel team mirrors a Slack channel: Wordsmith syncs its members from the channel, so you cannot add or remove them through the API.

Authentication

Requires an API key, or an OAuth token with directory:read.

Path parameters

team_id · string · required

The team id, from List Teams.

Response

Returns 200 with the team. member_ids, member_count and direct_member_count leave out suspended members, as in List Teams.

cURL

curl "https://api.wordsmith.ai/api/v1/teams/26fb01d1-34cc-4ec6-9823-53fdeb24c86e" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "26fb01d1-34cc-4ec6-9823-53fdeb24c86e",
  "name": "Legal",
  "parent_team_id": null,
  "member_count": 3,
  "direct_member_count": 2,
  "member_ids": [
    "4c98ef69-d5ef-4471-a2b8-89ded5b7b121",
    "d850a4e0-5c88-4a9c-80da-640eefde1bcd",
    "828b17cf-5f09-4edd-bcba-9d1de130a2e6"
  ],
  "hidden": false,
  "membership_source": "manual",
  "members": [
    { "user_id": "4c98ef69-d5ef-4471-a2b8-89ded5b7b121", "role": "admin" },
    { "user_id": "d850a4e0-5c88-4a9c-80da-640eefde1bcd", "role": "member" }
  ]
}

Errors

Status	error_code	When
403	insufficient_scope	The OAuth token does not hold directory:read.
404	resource_not_found	No team in your organisation has this id, or the caller cannot see it. A hidden team is visible only to its members and to people who can manage it. Also returned when teams are not enabled for your organisation.