@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/teams.md

@@ -0,0 +1,1395 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.teams`: Teams
+
+35 operations (16 read, 8 write, 10 destructive, 1 billable).
+
+No hand-written client covers this area. Call it through `g8.api.teams.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [teams.d.ts](teams.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addTeamAgent`](#op-addteamagent) | `POST /api/v1/teams/{team_id}/agents` | write | `team:write` | Add Team Agent |
+| [`addTeamMember`](#op-addteammember) | `POST /api/v1/teams/{team_id}/members` | write | `team:write` | Add Team Member |
+| [`assignCampaignToTeam`](#op-assigncampaigntoteam) | `POST /api/v1/teams/{team_id}/campaigns` | write | `team:write` | Assign Campaign To Team |
+| [`assignLinkedinAccountToTeam`](#op-assignlinkedinaccounttoteam) | `POST /api/v1/teams/{team_id}/linkedin-accounts` | write | `team:write` | Assign Linkedin Account To Team |
+| [`assignMailboxToTeam`](#op-assignmailboxtoteam) | `POST /api/v1/teams/{team_id}/mailboxes` | write | `team:write` | Assign Mailbox To Team |
+| [`assignPhoneToTeam`](#op-assignphonetoteam) | `POST /api/v1/teams/{team_id}/phone-numbers` | write | `team:write` | Assign Phone To Team |
+| [`autoComposeSuggest`](#op-autocomposesuggest) | `POST /api/v1/teams/auto-compose/suggest` | billable | `team:run` | Auto Compose Suggest |
+| [`createTeam`](#op-createteam) | `POST /api/v1/teams` | write | `team:write` | Create Team |
+| [`deleteTeam`](#op-deleteteam) | `DELETE /api/v1/teams/{team_id}` | destructive | `team:delete` | Delete Team |
+| [`getTeam`](#op-getteam) | `GET /api/v1/teams/{team_id}` | read | `team:read` | Get Team |
+| [`listAvailableAgents`](#op-listavailableagents) | `GET /api/v1/teams/available/agents` | read | `team:read` | List Available Agents |
+| [`listAvailableCampaigns`](#op-listavailablecampaigns) | `GET /api/v1/teams/available/campaigns` | read | `team:read` | List Available Campaigns |
+| [`listAvailableChatbots`](#op-listavailablechatbots) | `GET /api/v1/teams/available/chatbots` | read | `team:read` | List Available Chatbots |
+| [`listAvailableLinkedinAccounts`](#op-listavailablelinkedinaccounts) | `GET /api/v1/teams/available/linkedin-accounts` | read | `team:read` | List Available Linkedin Accounts |
+| [`listAvailableMailboxes`](#op-listavailablemailboxes) | `GET /api/v1/teams/available/mailboxes` | read | `team:read` | List Available Mailboxes |
+| [`listAvailablePhoneNumbers`](#op-listavailablephonenumbers) | `GET /api/v1/teams/available/phone-numbers` | read | `team:read` | List Available Phone Numbers |
+| [`listAvailableSequences`](#op-listavailablesequences) | `GET /api/v1/teams/available/sequences` | read | `team:read` | List Available Sequences |
+| [`listTeamAgents`](#op-listteamagents) | `GET /api/v1/teams/{team_id}/agents` | read | `team:read` | List Team Agents |
+| [`listTeamCampaigns`](#op-listteamcampaigns) | `GET /api/v1/teams/{team_id}/campaigns` | read | `team:read` | List Team Campaigns |
+| [`listTeamChatbots`](#op-listteamchatbots) | `GET /api/v1/teams/{team_id}/chatbots` | read | `team:read` | List Team Chatbots |
+| [`listTeamLinkedinAccounts`](#op-listteamlinkedinaccounts) | `GET /api/v1/teams/{team_id}/linkedin-accounts` | read | `team:read` | List Team Linkedin Accounts |
+| [`listTeamMailboxes`](#op-listteammailboxes) | `GET /api/v1/teams/{team_id}/mailboxes` | read | `team:read` | List Team Mailboxes |
+| [`listTeamPhoneNumbers`](#op-listteamphonenumbers) | `GET /api/v1/teams/{team_id}/phone-numbers` | read | `team:read` | List Team Phone Numbers |
+| [`listTeamSequences`](#op-listteamsequences) | `GET /api/v1/teams/{team_id}/sequences` | read | `team:read` | List Team Sequences |
+| [`listTeams`](#op-listteams) | `GET /api/v1/teams` | read | `team:read` | List Teams |
+| [`removeTeamAgent`](#op-removeteamagent) | `DELETE /api/v1/teams/{team_id}/agents/{user_id}` | destructive | `team:delete` | Remove Team Agent |
+| [`removeTeamMember`](#op-removeteammember) | `DELETE /api/v1/teams/{team_id}/members/{user_id}` | destructive | `team:delete` | Remove Team Member |
+| [`unassignCampaignFromTeam`](#op-unassigncampaignfromteam) | `DELETE /api/v1/teams/{team_id}/campaigns/{campaign_id}` | destructive | `team:delete` | Unassign Campaign From Team |
+| [`unassignLinkedinAccountByAssoc`](#op-unassignlinkedinaccountbyassoc) | `DELETE /api/v1/teams/{team_id}/linkedin-accounts/assoc/{assoc_id}` | destructive | `team:delete` | Unassign Linkedin Account By Assoc |
+| [`unassignLinkedinAccountFromTeam`](#op-unassignlinkedinaccountfromteam) | `DELETE /api/v1/teams/{team_id}/linkedin-accounts/{linkedin_account_id}` | destructive | `team:delete` | Unassign Linkedin Account From Team |
+| [`unassignMailboxFromTeam`](#op-unassignmailboxfromteam) | `DELETE /api/v1/teams/{team_id}/mailboxes/{mailbox_id}` | destructive | `team:delete` | Unassign Mailbox From Team |
+| [`unassignPhoneFromTeam`](#op-unassignphonefromteam) | `DELETE /api/v1/teams/{team_id}/phone-numbers/{phone_id}` | destructive | `team:delete` | Unassign Phone From Team |
+| [`updateTeam`](#op-updateteam) | `PUT /api/v1/teams/{team_id}` | write | `team:write` | Update Team |
+| [`updateTeamAgentRole`](#op-updateteamagentrole) | `PATCH /api/v1/teams/{team_id}/agents/{user_id}` | destructive | `team:delete` | Update Team Agent Role |
+| [`updateTeamMemberRole`](#op-updateteammemberrole) | `PUT /api/v1/teams/{team_id}/members/{user_id}` | destructive | `team:delete` | Update Team Member Role |
+
+---
+
+<a id="op-addteamagent"></a>
+
+### `g8.api.teams.addTeamAgent(input)`
+
+**Add Team Agent**
+
+- HTTP: `POST /api/v1/teams/{team_id}/agents`
+- operationId: `add_team_agent_teams__team_id__agents_post` (also callable as `g8.api.call("add_team_agent_teams__team_id__agents_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Put an AI agent on a team.
+
+An agent member is scoped exactly like a human one: it sees what the team
+sees. Delegated authority is bounded by the delegator's, so an agent
+cannot be given reach the caller does not have.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `TeamMemberAddRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamMemberAddRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.user_id` | `string` | yes | min length 1, max length 255 |
+| `body.team_role` | `string` | no | default `"member"`, max length 20 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.addTeamAgent({ path: { team_id: "id" }, body: { user_id: "id" } });
+```
+
+---
+
+<a id="op-addteammember"></a>
+
+### `g8.api.teams.addTeamMember(input)`
+
+**Add Team Member**
+
+- HTTP: `POST /api/v1/teams/{team_id}/members`
+- operationId: `add_team_member_teams__team_id__members_post` (also callable as `g8.api.call("add_team_member_teams__team_id__members_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Put a person on a team.
+
+This WIDENS what they can see: every `:team`-scoped permission they hold
+now resolves against this team's records too.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `TeamMemberAddRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamMemberAddRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.user_id` | `string` | yes | min length 1, max length 255 |
+| `body.team_role` | `string` | no | default `"member"`, max length 20 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.addTeamMember({ path: { team_id: "id" }, body: { user_id: "id" } });
+```
+
+---
+
+<a id="op-assigncampaigntoteam"></a>
+
+### `g8.api.teams.assignCampaignToTeam(input)`
+
+**Assign Campaign To Team**
+
+- HTTP: `POST /api/v1/teams/{team_id}/campaigns`
+- operationId: `assign_campaign_to_team_teams__team_id__campaigns_post` (also callable as `g8.api.call("assign_campaign_to_team_teams__team_id__campaigns_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Link a campaign to a team. It does not start or stop anything.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `AssignTeamCampaignRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignTeamCampaignRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.campaign_id` | `string` | yes | UUID of the campaign to link to this team. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.assignCampaignToTeam({ path: { team_id: "id" }, body: { campaign_id: "id" } });
+```
+
+---
+
+<a id="op-assignlinkedinaccounttoteam"></a>
+
+### `g8.api.teams.assignLinkedinAccountToTeam(input)`
+
+**Assign Linkedin Account To Team**
+
+- HTTP: `POST /api/v1/teams/{team_id}/linkedin-accounts`
+- operationId: `assign_linkedin_account_to_team_teams__team_id__linkedin_accounts_post` (also callable as `g8.api.call("assign_linkedin_account_to_team_teams__team_id__linkedin_accounts_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Attach a LinkedIn sending account to a team.
+
+Two spellings, both accepted because the app accepts both: the current
+`provider` + `account_ref` pair from
+`GET /teams/available/linkedin-accounts`, or the legacy
+`linkedin_account_id`. Send the pair for new integrations - the legacy id
+is ambiguous across providers.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `AssignLinkedInAccountRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignLinkedInAccountRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.account_ref` | `string \| null` | no | The provider's own account key. |
+| `body.linkedin_account_id` | `string (uuid) \| null` | no | Legacy account id. |
+| `body.provider` | `string \| null` | no | Which LinkedIn provider the account belongs to. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.assignLinkedinAccountToTeam({ path: { team_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-assignmailboxtoteam"></a>
+
+### `g8.api.teams.assignMailboxToTeam(input)`
+
+**Assign Mailbox To Team**
+
+- HTTP: `POST /api/v1/teams/{team_id}/mailboxes`
+- operationId: `assign_mailbox_to_team_teams__team_id__mailboxes_post` (also callable as `g8.api.call("assign_mailbox_to_team_teams__team_id__mailboxes_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Attach a mailbox to a team. Everyone on the team may then send from it.
+
+`object_id` is the integer `mailboxes.id` from
+`GET /teams/available/mailboxes`, not the mailbox address.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `AssignObjectRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignObjectRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.object_id` | `integer` | yes | Integer id of the mailbox or phone number to attach. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.assignMailboxToTeam({ path: { team_id: "id" }, body: { object_id: 123 } });
+```
+
+---
+
+<a id="op-assignphonetoteam"></a>
+
+### `g8.api.teams.assignPhoneToTeam(input)`
+
+**Assign Phone To Team**
+
+- HTTP: `POST /api/v1/teams/{team_id}/phone-numbers`
+- operationId: `assign_phone_to_team_teams__team_id__phone_numbers_post` (also callable as `g8.api.call("assign_phone_to_team_teams__team_id__phone_numbers_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Attach a phone number to a team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `AssignObjectRequest` | yes | Request body; fields below. |
+
+Body fields (`AssignObjectRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.object_id` | `integer` | yes | Integer id of the mailbox or phone number to attach. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.assignPhoneToTeam({ path: { team_id: "id" }, body: { object_id: 123 } });
+```
+
+---
+
+<a id="op-autocomposesuggest"></a>
+
+### `g8.api.teams.autoComposeSuggest(input?)`
+
+**Auto Compose Suggest**
+
+- HTTP: `POST /api/v1/teams/auto-compose/suggest`
+- operationId: `auto_compose_suggest_teams_auto_compose_suggest_post` (also callable as `g8.api.call("auto_compose_suggest_teams_auto_compose_suggest_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `team:run`
+
+Propose a team structure from the organisation's current universe.
+
+THIS SPENDS CREDITS. It reads every member, mailbox, number, campaign and
+sequence and runs a model over them, and the handler settles the usage
+afterwards - which is why it gates on `team:run` rather than plain write.
+
+It SUGGESTS only. Nothing is created until you send the result to
+`POST /teams`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.teams.autoComposeSuggest();
+```
+
+---
+
+<a id="op-createteam"></a>
+
+### `g8.api.teams.createTeam(input)`
+
+**Create Team**
+
+- HTTP: `POST /api/v1/teams`
+- operationId: `create_team_teams_post` (also callable as `g8.api.call("create_team_teams_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Create a team, with its members and channels, in ONE transaction.
+
+Everything in the body lands atomically: a team is never briefly visible
+with none of its mailboxes attached, and a rejected member id rolls the
+whole thing back rather than leaving a half-built team.
+
+409 when the name is already taken in this organisation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `TeamCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1, max length 100 |
+| `body.agent_id` | `string \| null` | no | max length 255 |
+| `body.campaign_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.chat_intent` | `string \| null` | no | 'support' \| 'sales' \| null |
+| `body.chatbot_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.color` | `string \| null` | no | Hex colour, e.g. #FF5733. An empty string clears it. max length 20, pattern `^(#[0-9A-Fa-f]{6})?$` |
+| `body.description` | `string \| null` | no |  |
+| `body.linkedin_account_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.mailbox_ids` | `Array<integer> \| null` | no |  |
+| `body.members` | `Array<WorkspaceMemberInput> \| null` | no |  |
+| `body.phone_number_ids` | `Array<integer> \| null` | no |  |
+| `body.sequence_ids` | `Array<string> \| null` | no |  |
+| `body.type` | `string` | no | default `"functional"`, max length 50 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.createTeam({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-deleteteam"></a>
+
+### `g8.api.teams.deleteTeam(input)`
+
+**Delete Team**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}`
+- operationId: `delete_team_teams__team_id__delete` (also callable as `g8.api.call("delete_team_teams__team_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Delete a team.
+
+Everyone who was on it loses whatever `:team`-scoped visibility the
+membership gave them. The records themselves are untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.deleteTeam({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-getteam"></a>
+
+### `g8.api.teams.getTeam(input)`
+
+**Get Team**
+
+- HTTP: `GET /api/v1/teams/{team_id}`
+- operationId: `get_team_teams__team_id__get` (also callable as `g8.api.call("get_team_teams__team_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+One team, with its full membership list.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.getTeam({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listavailableagents"></a>
+
+### `g8.api.teams.listAvailableAgents(input?)`
+
+**List Available Agents**
+
+- HTTP: `GET /api/v1/teams/available/agents`
+- operationId: `list_available_agents_teams_available_agents_get` (also callable as `g8.api.call("list_available_agents_teams_available_agents_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+AI agents that can be put on a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableAgents();
+```
+
+---
+
+<a id="op-listavailablecampaigns"></a>
+
+### `g8.api.teams.listAvailableCampaigns(input?)`
+
+**List Available Campaigns**
+
+- HTTP: `GET /api/v1/teams/available/campaigns`
+- operationId: `list_available_campaigns_teams_available_campaigns_get` (also callable as `g8.api.call("list_available_campaigns_teams_available_campaigns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Campaigns that can be linked to a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableCampaigns();
+```
+
+---
+
+<a id="op-listavailablechatbots"></a>
+
+### `g8.api.teams.listAvailableChatbots(input?)`
+
+**List Available Chatbots**
+
+- HTTP: `GET /api/v1/teams/available/chatbots`
+- operationId: `list_available_chatbots_teams_available_chatbots_get` (also callable as `g8.api.call("list_available_chatbots_teams_available_chatbots_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Web chatbots that can be linked to a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableChatbots();
+```
+
+---
+
+<a id="op-listavailablelinkedinaccounts"></a>
+
+### `g8.api.teams.listAvailableLinkedinAccounts(input?)`
+
+**List Available Linkedin Accounts**
+
+- HTTP: `GET /api/v1/teams/available/linkedin-accounts`
+- operationId: `list_available_linkedin_accounts_teams_available_linkedin_accounts_get` (also callable as `g8.api.call("list_available_linkedin_accounts_teams_available_linkedin_accounts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+LinkedIn sending accounts that can be attached to a team.
+
+Spans both providers the organisation may be on, and the response says
+which provider each account belongs to - that pair is what
+`POST /teams/{team_id}/linkedin-accounts` wants.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableLinkedinAccounts();
+```
+
+---
+
+<a id="op-listavailablemailboxes"></a>
+
+### `g8.api.teams.listAvailableMailboxes(input?)`
+
+**List Available Mailboxes**
+
+- HTTP: `GET /api/v1/teams/available/mailboxes`
+- operationId: `list_available_mailboxes_teams_available_mailboxes_get` (also callable as `g8.api.call("list_available_mailboxes_teams_available_mailboxes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Mailboxes that can be attached to a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableMailboxes();
+```
+
+---
+
+<a id="op-listavailablephonenumbers"></a>
+
+### `g8.api.teams.listAvailablePhoneNumbers(input?)`
+
+**List Available Phone Numbers**
+
+- HTTP: `GET /api/v1/teams/available/phone-numbers`
+- operationId: `list_available_phone_numbers_teams_available_phone_numbers_get` (also callable as `g8.api.call("list_available_phone_numbers_teams_available_phone_numbers_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Phone numbers that can be attached to a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailablePhoneNumbers();
+```
+
+---
+
+<a id="op-listavailablesequences"></a>
+
+### `g8.api.teams.listAvailableSequences(input?)`
+
+**List Available Sequences**
+
+- HTTP: `GET /api/v1/teams/available/sequences`
+- operationId: `list_available_sequences_teams_available_sequences_get` (also callable as `g8.api.call("list_available_sequences_teams_available_sequences_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Sequences that can be linked to a team.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listAvailableSequences();
+```
+
+---
+
+<a id="op-listteamagents"></a>
+
+### `g8.api.teams.listTeamAgents(input)`
+
+**List Team Agents**
+
+- HTTP: `GET /api/v1/teams/{team_id}/agents`
+- operationId: `list_team_agents_teams__team_id__agents_get` (also callable as `g8.api.call("list_team_agents_teams__team_id__agents_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The AI agents that are members of this team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamAgents({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteamcampaigns"></a>
+
+### `g8.api.teams.listTeamCampaigns(input)`
+
+**List Team Campaigns**
+
+- HTTP: `GET /api/v1/teams/{team_id}/campaigns`
+- operationId: `list_team_campaigns_teams__team_id__campaigns_get` (also callable as `g8.api.call("list_team_campaigns_teams__team_id__campaigns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The campaigns this team runs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamCampaigns({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteamchatbots"></a>
+
+### `g8.api.teams.listTeamChatbots(input)`
+
+**List Team Chatbots**
+
+- HTTP: `GET /api/v1/teams/{team_id}/chatbots`
+- operationId: `list_team_chatbots_teams__team_id__chatbots_get` (also callable as `g8.api.call("list_team_chatbots_teams__team_id__chatbots_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The web chatbots routed to this team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamChatbots({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteamlinkedinaccounts"></a>
+
+### `g8.api.teams.listTeamLinkedinAccounts(input)`
+
+**List Team Linkedin Accounts**
+
+- HTTP: `GET /api/v1/teams/{team_id}/linkedin-accounts`
+- operationId: `list_team_linkedin_accounts_teams__team_id__linkedin_accounts_get` (also callable as `g8.api.call("list_team_linkedin_accounts_teams__team_id__linkedin_accounts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The LinkedIn accounts this team may send from.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamLinkedinAccounts({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteammailboxes"></a>
+
+### `g8.api.teams.listTeamMailboxes(input)`
+
+**List Team Mailboxes**
+
+- HTTP: `GET /api/v1/teams/{team_id}/mailboxes`
+- operationId: `list_team_mailboxes_teams__team_id__mailboxes_get` (also callable as `g8.api.call("list_team_mailboxes_teams__team_id__mailboxes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The mailboxes this team may send from.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamMailboxes({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteamphonenumbers"></a>
+
+### `g8.api.teams.listTeamPhoneNumbers(input)`
+
+**List Team Phone Numbers**
+
+- HTTP: `GET /api/v1/teams/{team_id}/phone-numbers`
+- operationId: `list_team_phone_numbers_teams__team_id__phone_numbers_get` (also callable as `g8.api.call("list_team_phone_numbers_teams__team_id__phone_numbers_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The phone numbers this team may call and text from.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamPhoneNumbers({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteamsequences"></a>
+
+### `g8.api.teams.listTeamSequences(input)`
+
+**List Team Sequences**
+
+- HTTP: `GET /api/v1/teams/{team_id}/sequences`
+- operationId: `list_team_sequences_teams__team_id__sequences_get` (also callable as `g8.api.call("list_team_sequences_teams__team_id__sequences_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+The sequences this team runs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeamSequences({ path: { team_id: "id" } });
+```
+
+---
+
+<a id="op-listteams"></a>
+
+### `g8.api.teams.listTeams(input?)`
+
+**List Teams**
+
+- HTTP: `GET /api/v1/teams`
+- operationId: `list_teams_teams_get` (also callable as `g8.api.call("list_teams_teams_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `team:read`
+
+Every team in the organisation, with its channels and member preview.
+
+All aggregates are computed in grouped queries, so this stays one round
+trip however many teams there are.
+
+**Input**: none.
+
+**Returns** `ApiResponse_OrgListPayload_`: the envelope `{ data: OrgListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OrgListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.teams.listTeams();
+```
+
+---
+
+<a id="op-removeteamagent"></a>
+
+### `g8.api.teams.removeTeamAgent(input)`
+
+**Remove Team Agent**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/agents/{user_id}`
+- operationId: `remove_team_agent_teams__team_id__agents__user_id__delete` (also callable as `g8.api.call("remove_team_agent_teams__team_id__agents__user_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Take an AI agent off a team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.user_id` | `string` | yes | Agent user id. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.removeTeamAgent({ path: { team_id: "id", user_id: "id" } });
+```
+
+---
+
+<a id="op-removeteammember"></a>
+
+### `g8.api.teams.removeTeamMember(input)`
+
+**Remove Team Member**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/members/{user_id}`
+- operationId: `remove_team_member_teams__team_id__members__user_id__delete` (also callable as `g8.api.call("remove_team_member_teams__team_id__members__user_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Take a person off a team. They keep their org role; they lose the team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.user_id` | `string` | yes | Identity-provider user id. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.removeTeamMember({ path: { team_id: "id", user_id: "id" } });
+```
+
+---
+
+<a id="op-unassigncampaignfromteam"></a>
+
+### `g8.api.teams.unassignCampaignFromTeam(input)`
+
+**Unassign Campaign From Team**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/campaigns/{campaign_id}`
+- operationId: `unassign_campaign_from_team_teams__team_id__campaigns__campaign_id__delete` (also callable as `g8.api.call("unassign_campaign_from_team_teams__team_id__campaigns__campaign_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Unlink a campaign from a team. The campaign itself is untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.campaign_id` | `string` | yes | Campaign id (UUID). |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.unassignCampaignFromTeam({ path: { team_id: "id", campaign_id: "id" } });
+```
+
+---
+
+<a id="op-unassignlinkedinaccountbyassoc"></a>
+
+### `g8.api.teams.unassignLinkedinAccountByAssoc(input)`
+
+**Unassign Linkedin Account By Assoc**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/linkedin-accounts/assoc/{assoc_id}`
+- operationId: `unassign_linkedin_account_by_assoc_teams__team_id__linkedin_accounts_assoc__assoc_id__delete` (also callable as `g8.api.call("unassign_linkedin_account_by_assoc_teams__team_id__linkedin_accounts_assoc__assoc_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Detach ONE association by its own id.
+
+Use this rather than the account-id form when the same account is attached
+more than once: the account-id form removes whichever association it finds,
+and this names exactly the one you mean. Declared BEFORE the account-id
+route so the `assoc` literal is reachable.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.assoc_id` | `string` | yes | Association row id (UUID). |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.unassignLinkedinAccountByAssoc({ path: { team_id: "id", assoc_id: "id" } });
+```
+
+---
+
+<a id="op-unassignlinkedinaccountfromteam"></a>
+
+### `g8.api.teams.unassignLinkedinAccountFromTeam(input)`
+
+**Unassign Linkedin Account From Team**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/linkedin-accounts/{linkedin_account_id}`
+- operationId: `unassign_linkedin_account_from_team_teams__team_id__linkedin_accounts__linkedin_account_id__delete` (also callable as `g8.api.call("unassign_linkedin_account_from_team_teams__team_id__linkedin_accounts__linkedin_account_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Detach a LinkedIn account from a team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.linkedin_account_id` | `string` | yes | LinkedIn account id (UUID). |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.unassignLinkedinAccountFromTeam({ path: { team_id: "id", linkedin_account_id: "id" } });
+```
+
+---
+
+<a id="op-unassignmailboxfromteam"></a>
+
+### `g8.api.teams.unassignMailboxFromTeam(input)`
+
+**Unassign Mailbox From Team**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/mailboxes/{mailbox_id}`
+- operationId: `unassign_mailbox_from_team_teams__team_id__mailboxes__mailbox_id__delete` (also callable as `g8.api.call("unassign_mailbox_from_team_teams__team_id__mailboxes__mailbox_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Detach a mailbox. The mailbox itself survives; the team loses access.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.mailbox_id` | `integer` | yes | Integer `mailboxes.id`. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.unassignMailboxFromTeam({ path: { team_id: "id", mailbox_id: 123 } });
+```
+
+---
+
+<a id="op-unassignphonefromteam"></a>
+
+### `g8.api.teams.unassignPhoneFromTeam(input)`
+
+**Unassign Phone From Team**
+
+- HTTP: `DELETE /api/v1/teams/{team_id}/phone-numbers/{phone_id}`
+- operationId: `unassign_phone_from_team_teams__team_id__phone_numbers__phone_id__delete` (also callable as `g8.api.call("unassign_phone_from_team_teams__team_id__phone_numbers__phone_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Detach a phone number from a team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.phone_id` | `integer` | yes | Integer phone-number id. |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.unassignPhoneFromTeam({ path: { team_id: "id", phone_id: 123 } });
+```
+
+---
+
+<a id="op-updateteam"></a>
+
+### `g8.api.teams.updateTeam(input)`
+
+**Update Team**
+
+- HTTP: `PUT /api/v1/teams/{team_id}`
+- operationId: `update_team_teams__team_id__put` (also callable as `g8.api.call("update_team_teams__team_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `team:write`
+
+Update a team, and optionally re-attach everything on it in one call.
+
+An omitted `*_ids` list LEAVES that attachment alone. A list that IS
+present REPLACES it, so sending `[]` detaches every mailbox (or number, or
+campaign) the team had. Omitting and sending an empty list are different
+instructions and the second one is destructive - the handler diffs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `body` | `TeamUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.agent_id` | `string \| null` | no | Single workspace AI agent; empty string clears it. max length 255 |
+| `body.campaign_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.chat_intent` | `string \| null` | no | 'support' \| 'sales' \| null. An empty string clears it. |
+| `body.chatbot_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.color` | `string \| null` | no | Hex colour, e.g. #FF5733. An empty string clears it. max length 20, pattern `^(#[0-9A-Fa-f]{6})?$` |
+| `body.description` | `string \| null` | no |  |
+| `body.linkedin_account_ids` | `Array<string (uuid)> \| null` | no |  |
+| `body.mailbox_ids` | `Array<integer> \| null` | no |  |
+| `body.members` | `Array<WorkspaceMemberInput> \| null` | no |  |
+| `body.name` | `string \| null` | no | min length 1, max length 100 |
+| `body.phone_number_ids` | `Array<integer> \| null` | no |  |
+| `body.sequence_ids` | `Array<string> \| null` | no |  |
+| `body.type` | `string \| null` | no | max length 50 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.teams.updateTeam({ path: { team_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateteamagentrole"></a>
+
+### `g8.api.teams.updateTeamAgentRole(input)`
+
+**Update Team Agent Role**
+
+- HTTP: `PATCH /api/v1/teams/{team_id}/agents/{user_id}`
+- operationId: `update_team_agent_role_teams__team_id__agents__user_id__patch` (also callable as `g8.api.call("update_team_agent_role_teams__team_id__agents__user_id__patch", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Change an agent's role within this team. REPLACES the previous one.
+
+Tiered `destructive` for the same reason as its human twin: it is a
+privilege change on a membership row, not an edit to a label.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.user_id` | `string` | yes | Agent user id. |
+| `body` | `TeamMemberRoleUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamMemberRoleUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.team_role` | `string` | yes | max length 20 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.updateTeamAgentRole({
+  path: { team_id: "id", user_id: "id" },
+  body: { team_role: "example" },
+});
+```
+
+---
+
+<a id="op-updateteammemberrole"></a>
+
+### `g8.api.teams.updateTeamMemberRole(input)`
+
+**Update Team Member Role**
+
+- HTTP: `PUT /api/v1/teams/{team_id}/members/{user_id}`
+- operationId: `update_team_member_role_teams__team_id__members__user_id__put` (also callable as `g8.api.call("update_team_member_role_teams__team_id__members__user_id__put", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `team:delete`
+
+Change someone's role WITHIN this team. Their previous role is gone.
+
+`cb_team_user_memberships` holds one row per (team, user), so this
+REPLACES rather than adds. Tiered `destructive` by an explicit rule
+because it is a privilege change - promoting a colleague to team manager
+must not be the same grant as renaming the team.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.team_id` | `string` | yes | Team id (UUID). |
+| `path.user_id` | `string` | yes | Identity-provider user id. |
+| `body` | `TeamMemberRoleUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`TeamMemberRoleUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.team_role` | `string` | yes | max length 20 |
+
+**Returns** `ApiResponse_OrgPayload_`: the envelope `{ data: OrgPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.teams.updateTeamMemberRole({
+  path: { team_id: "id", user_id: "id" },
+  body: { team_role: "example" },
+});
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-workspacememberinput"></a>
+
+### `WorkspaceMemberInput`
+
+One member in a team's single-save membership list.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `user_id` | `string` | yes | min length 1, max length 255 |
+| `role` | `"member" \| "manager"` | no | member \| manager default `"member"` |