@graph8/sdk 0.245.0 → 0.260.0

package/docs/api/teams.d.ts

@@ -0,0 +1,784 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.teams` (Teams): 35 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"add_team_agent_teams__team_id__agents_post">;
+ *
+ * Reference with examples: teams.md
+ */
+/* eslint-disable */
+
+/** `g8.api.teams.<member>` -> the operationId it calls. */
+export interface TeamsMembers {
+  addTeamAgent: "add_team_agent_teams__team_id__agents_post";
+  addTeamMember: "add_team_member_teams__team_id__members_post";
+  assignCampaignToTeam: "assign_campaign_to_team_teams__team_id__campaigns_post";
+  assignLinkedinAccountToTeam: "assign_linkedin_account_to_team_teams__team_id__linkedin_accounts_post";
+  assignMailboxToTeam: "assign_mailbox_to_team_teams__team_id__mailboxes_post";
+  assignPhoneToTeam: "assign_phone_to_team_teams__team_id__phone_numbers_post";
+  autoComposeSuggest: "auto_compose_suggest_teams_auto_compose_suggest_post";
+  createTeam: "create_team_teams_post";
+  deleteTeam: "delete_team_teams__team_id__delete";
+  getTeam: "get_team_teams__team_id__get";
+  listAvailableAgents: "list_available_agents_teams_available_agents_get";
+  listAvailableCampaigns: "list_available_campaigns_teams_available_campaigns_get";
+  listAvailableChatbots: "list_available_chatbots_teams_available_chatbots_get";
+  listAvailableLinkedinAccounts: "list_available_linkedin_accounts_teams_available_linkedin_accounts_get";
+  listAvailableMailboxes: "list_available_mailboxes_teams_available_mailboxes_get";
+  listAvailablePhoneNumbers: "list_available_phone_numbers_teams_available_phone_numbers_get";
+  listAvailableSequences: "list_available_sequences_teams_available_sequences_get";
+  listTeamAgents: "list_team_agents_teams__team_id__agents_get";
+  listTeamCampaigns: "list_team_campaigns_teams__team_id__campaigns_get";
+  listTeamChatbots: "list_team_chatbots_teams__team_id__chatbots_get";
+  listTeamLinkedinAccounts: "list_team_linkedin_accounts_teams__team_id__linkedin_accounts_get";
+  listTeamMailboxes: "list_team_mailboxes_teams__team_id__mailboxes_get";
+  listTeamPhoneNumbers: "list_team_phone_numbers_teams__team_id__phone_numbers_get";
+  listTeamSequences: "list_team_sequences_teams__team_id__sequences_get";
+  listTeams: "list_teams_teams_get";
+  removeTeamAgent: "remove_team_agent_teams__team_id__agents__user_id__delete";
+  removeTeamMember: "remove_team_member_teams__team_id__members__user_id__delete";
+  unassignCampaignFromTeam: "unassign_campaign_from_team_teams__team_id__campaigns__campaign_id__delete";
+  unassignLinkedinAccountByAssoc: "unassign_linkedin_account_by_assoc_teams__team_id__linkedin_accounts_assoc__assoc_id__delete";
+  unassignLinkedinAccountFromTeam: "unassign_linkedin_account_from_team_teams__team_id__linkedin_accounts__linkedin_account_id__delete";
+  unassignMailboxFromTeam: "unassign_mailbox_from_team_teams__team_id__mailboxes__mailbox_id__delete";
+  unassignPhoneFromTeam: "unassign_phone_from_team_teams__team_id__phone_numbers__phone_id__delete";
+  updateTeam: "update_team_teams__team_id__put";
+  updateTeamAgentRole: "update_team_agent_role_teams__team_id__agents__user_id__patch";
+  updateTeamMemberRole: "update_team_member_role_teams__team_id__members__user_id__put";
+}
+
+/** Input and output of every `g8.api.teams` operation, keyed by operationId. */
+export interface TeamsOperations {
+  /**
+   * POST /teams/{team_id}/agents
+   * Add Team Agent
+   * tier: write · scope: team:write
+   */
+  add_team_agent_teams__team_id__agents_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamMemberAddRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/{team_id}/members
+   * Add Team Member
+   * tier: write · scope: team:write
+   */
+  add_team_member_teams__team_id__members_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamMemberAddRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/{team_id}/campaigns
+   * Assign Campaign To Team
+   * tier: write · scope: team:write
+   */
+  assign_campaign_to_team_teams__team_id__campaigns_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AssignTeamCampaignRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/{team_id}/linkedin-accounts
+   * Assign Linkedin Account To Team
+   * tier: write · scope: team:write
+   */
+  assign_linkedin_account_to_team_teams__team_id__linkedin_accounts_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AssignLinkedInAccountRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/{team_id}/mailboxes
+   * Assign Mailbox To Team
+   * tier: write · scope: team:write
+   */
+  assign_mailbox_to_team_teams__team_id__mailboxes_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AssignObjectRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/{team_id}/phone-numbers
+   * Assign Phone To Team
+   * tier: write · scope: team:write
+   */
+  assign_phone_to_team_teams__team_id__phone_numbers_post: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AssignObjectRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams/auto-compose/suggest
+   * Auto Compose Suggest
+   * tier: billable · scope: team:run
+   */
+  auto_compose_suggest_teams_auto_compose_suggest_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * POST /teams
+   * Create Team
+   * tier: write · scope: team:write
+   */
+  create_team_teams_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamCreateRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}
+   * Delete Team
+   * tier: destructive · scope: team:delete
+   */
+  delete_team_teams__team_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * GET /teams/{team_id}
+   * Get Team
+   * tier: read · scope: team:read
+   */
+  get_team_teams__team_id__get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * GET /teams/available/agents
+   * List Available Agents
+   * tier: read · scope: team:read
+   */
+  list_available_agents_teams_available_agents_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/campaigns
+   * List Available Campaigns
+   * tier: read · scope: team:read
+   */
+  list_available_campaigns_teams_available_campaigns_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/chatbots
+   * List Available Chatbots
+   * tier: read · scope: team:read
+   */
+  list_available_chatbots_teams_available_chatbots_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/linkedin-accounts
+   * List Available Linkedin Accounts
+   * tier: read · scope: team:read
+   */
+  list_available_linkedin_accounts_teams_available_linkedin_accounts_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/mailboxes
+   * List Available Mailboxes
+   * tier: read · scope: team:read
+   */
+  list_available_mailboxes_teams_available_mailboxes_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/phone-numbers
+   * List Available Phone Numbers
+   * tier: read · scope: team:read
+   */
+  list_available_phone_numbers_teams_available_phone_numbers_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/available/sequences
+   * List Available Sequences
+   * tier: read · scope: team:read
+   */
+  list_available_sequences_teams_available_sequences_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/agents
+   * List Team Agents
+   * tier: read · scope: team:read
+   */
+  list_team_agents_teams__team_id__agents_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/campaigns
+   * List Team Campaigns
+   * tier: read · scope: team:read
+   */
+  list_team_campaigns_teams__team_id__campaigns_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/chatbots
+   * List Team Chatbots
+   * tier: read · scope: team:read
+   */
+  list_team_chatbots_teams__team_id__chatbots_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/linkedin-accounts
+   * List Team Linkedin Accounts
+   * tier: read · scope: team:read
+   */
+  list_team_linkedin_accounts_teams__team_id__linkedin_accounts_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/mailboxes
+   * List Team Mailboxes
+   * tier: read · scope: team:read
+   */
+  list_team_mailboxes_teams__team_id__mailboxes_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/phone-numbers
+   * List Team Phone Numbers
+   * tier: read · scope: team:read
+   */
+  list_team_phone_numbers_teams__team_id__phone_numbers_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams/{team_id}/sequences
+   * List Team Sequences
+   * tier: read · scope: team:read
+   */
+  list_team_sequences_teams__team_id__sequences_get: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * GET /teams
+   * List Teams
+   * tier: read · scope: team:read
+   */
+  list_teams_teams_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgListPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/agents/{user_id}
+   * Remove Team Agent
+   * tier: destructive · scope: team:delete
+   */
+  remove_team_agent_teams__team_id__agents__user_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Agent user id. */
+      user_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/members/{user_id}
+   * Remove Team Member
+   * tier: destructive · scope: team:delete
+   */
+  remove_team_member_teams__team_id__members__user_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Identity-provider user id. */
+      user_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/campaigns/{campaign_id}
+   * Unassign Campaign From Team
+   * tier: destructive · scope: team:delete
+   */
+  unassign_campaign_from_team_teams__team_id__campaigns__campaign_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Campaign id (UUID). */
+      campaign_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/linkedin-accounts/assoc/{assoc_id}
+   * Unassign Linkedin Account By Assoc
+   * tier: destructive · scope: team:delete
+   */
+  unassign_linkedin_account_by_assoc_teams__team_id__linkedin_accounts_assoc__assoc_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Association row id (UUID). */
+      assoc_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/linkedin-accounts/{linkedin_account_id}
+   * Unassign Linkedin Account From Team
+   * tier: destructive · scope: team:delete
+   */
+  unassign_linkedin_account_from_team_teams__team_id__linkedin_accounts__linkedin_account_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** LinkedIn account id (UUID). */
+      linkedin_account_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/mailboxes/{mailbox_id}
+   * Unassign Mailbox From Team
+   * tier: destructive · scope: team:delete
+   */
+  unassign_mailbox_from_team_teams__team_id__mailboxes__mailbox_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Integer `mailboxes.id`. */
+      mailbox_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * DELETE /teams/{team_id}/phone-numbers/{phone_id}
+   * Unassign Phone From Team
+   * tier: destructive · scope: team:delete
+   */
+  unassign_phone_from_team_teams__team_id__phone_numbers__phone_id__delete: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Integer phone-number id. */
+      phone_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * PUT /teams/{team_id}
+   * Update Team
+   * tier: write · scope: team:write
+   */
+  update_team_teams__team_id__put: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamUpdateRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * PATCH /teams/{team_id}/agents/{user_id}
+   * Update Team Agent Role
+   * tier: destructive · scope: team:delete
+   */
+  update_team_agent_role_teams__team_id__agents__user_id__patch: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Agent user id. */
+      user_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamMemberRoleUpdateRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+  /**
+   * PUT /teams/{team_id}/members/{user_id}
+   * Update Team Member Role
+   * tier: destructive · scope: team:delete
+   */
+  update_team_member_role_teams__team_id__members__user_id__put: {
+    input: {
+    path: {
+      /** Team id (UUID). */
+      team_id: string;
+      /** Identity-provider user id. */
+      user_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: TeamMemberRoleUpdateRequest;
+  };
+    output: ApiResponse_OrgPayload_;
+  };
+}
+
+// 13 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_OrgListPayload_ {
+  data: OrgListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_OrgPayload_ {
+  data: OrgPayload;
+  pagination?: PaginationMeta | null;
+}
+
+/**
+ * Attach a LinkedIn sending account. Mirrors `teams.AssignLinkedInAccountDTO`.
+ *
+ * All three fields are optional because two spellings are supported: the
+ * current `provider` + `account_ref` pair, and the legacy
+ * `linkedin_account_id`. The handler validates that one of them is usable.
+ */
+export interface AssignLinkedInAccountRequest {
+  /** The provider's own account key. */
+  account_ref?: string | null;
+  /** Legacy account id. */
+  linkedin_account_id?: string | null;
+  /** Which LinkedIn provider the account belongs to. */
+  provider?: string | null;
+}
+
+/** Attach a mailbox or a phone number. Mirrors `teams.AssignObjectDTO`. */
+export interface AssignObjectRequest {
+  /** Integer id of the mailbox or phone number to attach. */
+  object_id: number;
+}
+
+/** Link a campaign to a team. Mirrors `teams.AssignTeamCampaignDTO`. */
+export interface AssignTeamCampaignRequest {
+  /** UUID of the campaign to link to this team. */
+  campaign_id: string;
+}
+
+/**
+ * An open envelope for a LIST result, so a bare list keeps its shape.
+ *
+ * Most of these handlers return a bare `list[...]`; a few return a named
+ * envelope (`{"team_members": [...], "total": n}`). Both are reachable as
+ * `items`, and a named envelope KEEPS its own key as well so a caller
+ * already reading the app's shape is not broken by the wrapper.
+ */
+export interface OrgListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for a single role, team, member or account record.
+ *
+ * Open on purpose. The app's own response models on this surface grow with
+ * the product - `RoleResponse` gained `rep_limits` and `manages_role_slugs`,
+ * `TeamResponse` gained channel counts and a campaign count - and a pinned
+ * mirror would SILENTLY DROP whatever it had not caught up on. A dropped
+ * permission in a role read is the worst possible kind of stale: it reads as
+ * "they do not have it".
+ */
+export type OrgPayload = Record<string, unknown>;
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * Create a team. Mirrors `teams.TeamCreateDTO`.
+ *
+ * Every `*_ids` list is applied in the SAME transaction as the team row, so
+ * a team is never briefly visible with none of its channels attached.
+ */
+export interface TeamCreateRequest {
+  agent_id?: string | null;
+  campaign_ids?: Array<string> | null;
+  /** 'support' | 'sales' | null */
+  chat_intent?: string | null;
+  chatbot_ids?: Array<string> | null;
+  /** Hex colour, e.g. #FF5733. An empty string clears it. */
+  color?: string | null;
+  description?: string | null;
+  linkedin_account_ids?: Array<string> | null;
+  mailbox_ids?: Array<number> | null;
+  members?: Array<WorkspaceMemberInput> | null;
+  name: string;
+  phone_number_ids?: Array<number> | null;
+  sequence_ids?: Array<string> | null;
+  type?: string;
+}
+
+/** Put a person (or an agent) on a team. Mirrors `teams.TeamMemberAddDTO`. */
+export interface TeamMemberAddRequest {
+  team_role?: string;
+  user_id: string;
+}
+
+/** Change someone's role WITHIN a team. Mirrors `teams.TeamMemberUpdateDTO`. */
+export interface TeamMemberRoleUpdateRequest {
+  team_role: string;
+}
+
+/**
+ * Update a team. Mirrors `teams.TeamUpdateDTO`.
+ *
+ * An omitted `*_ids` list LEAVES that attachment alone; a list that is
+ * present REPLACES it (the handler diffs). Sending `[]` therefore detaches
+ * everything of that kind, which is not the same instruction as omitting it.
+ */
+export interface TeamUpdateRequest {
+  /** Single workspace AI agent; empty string clears it. */
+  agent_id?: string | null;
+  campaign_ids?: Array<string> | null;
+  /** 'support' | 'sales' | null. An empty string clears it. */
+  chat_intent?: string | null;
+  chatbot_ids?: Array<string> | null;
+  /** Hex colour, e.g. #FF5733. An empty string clears it. */
+  color?: string | null;
+  description?: string | null;
+  linkedin_account_ids?: Array<string> | null;
+  mailbox_ids?: Array<number> | null;
+  members?: Array<WorkspaceMemberInput> | null;
+  name?: string | null;
+  phone_number_ids?: Array<number> | null;
+  sequence_ids?: Array<string> | null;
+  type?: string | null;
+}
+
+/** One member in a team's single-save membership list. */
+export interface WorkspaceMemberInput {
+  /** member | manager */
+  role?: "member" | "manager";
+  user_id: string;
+}