Get Team

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

{
  "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" }
  ]
}

GET

api

teams

{team_id}

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

{
  "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

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 "https://api.wordsmith.ai/api/v1/teams/26fb01d1-34cc-4ec6-9823-53fdeb24c86e" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

{
  "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.

Preview

Agents, playbooks and blueprints

Sessions

Playbook authoring

Drafts

Files

Document actions

Operations

Research

Reports

Reviews

Organisation

Sharing

Usage and value

Repositories and search

Authentication

Path parameters

Response

Errors

​Authentication

​Path parameters

​Response

​Errors

Authentication

Path parameters

Response

Errors