{"openapi":"3.2.1","info":{"title":"Communicate Public REST API","version":"0.1.5","summary":"Scoped agent chat, account credential lifecycle and workspace bootstrap operations.","description":"Canonical external schema for implemented REST operations. Account credentials and application sessions authorize the documented account and workspace operations separately from workspace keys. Exchange a workspace API-key client ID and secret for a short-lived OAuth access token, or use the `ck_` key directly for backward compatibility. `requestId` is optional but, when supplied, becomes the idempotency key for retries of the same chat input."},"servers":[{"url":"https://app.communicate.so/api/v1","description":"Canonical external base URL served through the Next.js /api/v1 rewrite."}],"security":[{"oauth2":[]},{"bearerAuth":[]}],"paths":{"/account-credentials/bootstrap":{"post":{"operationId":"bootstrapAccountCredential","summary":"Obtain an account credential with verified email and password proof","tags":["Account credentials"],"description":"Provide verified account email and current password to obtain an explicit account credential without cookies or Origin. Uses the existing Better Auth password verification and rate limits. No session cookie is returned. The issuer session is kept server-side and bounds credential validity. The secret is returned once; do not put credentials in command arguments or logs.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialBootstrap"}}}},"responses":{"201":{"description":"Obtain an account credential with verified email and password proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialReceipt"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Identity service or freshly issued session unavailable."}}}},"/account-credentials":{"post":{"operationId":"createAccountCredential","summary":"Create an explicit user-bound account credential","tags":["Account credentials"],"description":"Use an explicit credentials:write account bearer grant or a live email-verified application session, plus the current account password as fresh identity proof. Cookie writes require a trusted Origin. Machine callers cannot issue scopes beyond their own grant or outlive it. Creation and rotation return the secret once; metadata never includes it. Scope and expiry can only be narrowed. Issued credentials expire within 24 hours and no later than their issuer session; session revocation invalidates them.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["credentials:write"],"parameters":[{"name":"Origin","in":"header","required":false,"description":"Required for cookie authentication: an exact trusted application origin configured by the server. Bearer requests do not require Origin.","schema":{"type":"string","format":"uri"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialCreate"}}}},"responses":{"201":{"description":"Create an explicit user-bound account credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialReceipt"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Identity service or freshly issued session unavailable."}}},"get":{"operationId":"listAccountCredentials","summary":"List owned credential metadata with bounded pagination","tags":["Account credentials"],"description":"Use an explicit credentials:read account bearer grant or a live email-verified application session. Returns only owned metadata, including revocation and rotation history, ordered by descending credential ID. Follow nextCursor until null.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["credentials:read"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"List owned credential metadata with bounded pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialList"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."}}}},"/account-credentials/{credentialId}":{"patch":{"operationId":"editAccountCredential","summary":"Rename or narrow an owned active credential","tags":["Account credentials"],"description":"Use an explicit credentials:write account bearer grant or a live email-verified application session, plus the current account password as fresh identity proof. Cookie writes require a trusted Origin. Machine callers cannot issue scopes beyond their own grant or outlive it. Creation and rotation return the secret once; metadata never includes it. Scope and expiry can only be narrowed. Issued credentials expire within 24 hours and no later than their issuer session; session revocation invalidates them.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["credentials:write"],"parameters":[{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Origin","in":"header","required":false,"description":"Required for cookie authentication: an exact trusted application origin configured by the server. Bearer requests do not require Origin.","schema":{"type":"string","format":"uri"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialEdit"}}}},"responses":{"200":{"description":"Rename or narrow an owned active credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialMetadata"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"404":{"description":"Credential not found in the authenticated user account."},"409":{"description":"Credential is inactive, already rotated, or requested scopes or expiry exceed its existing authority."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Identity service or freshly issued session unavailable."}}},"delete":{"operationId":"revokeAccountCredential","summary":"Revoke an owned credential without deleting its history","tags":["Account credentials"],"description":"Use an explicit credentials:write account bearer grant or a live email-verified application session, plus the current account password as fresh identity proof. Cookie writes require a trusted Origin. Machine callers cannot issue scopes beyond their own grant or outlive it. Creation and rotation return the secret once; metadata never includes it. Scope and expiry can only be narrowed. Issued credentials expire within 24 hours and no later than their issuer session; session revocation invalidates them.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["credentials:write"],"parameters":[{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Origin","in":"header","required":false,"description":"Required for cookie authentication: an exact trusted application origin configured by the server. Bearer requests do not require Origin.","schema":{"type":"string","format":"uri"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialProof"}}}},"responses":{"200":{"description":"Revoke an owned credential without deleting its history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialRevocation"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"404":{"description":"Credential not found in the authenticated user account."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Identity service or freshly issued session unavailable."}}}},"/account-credentials/{credentialId}/rotate":{"post":{"operationId":"rotateAccountCredential","summary":"Replace a credential atomically without expanding its authority","tags":["Account credentials"],"description":"Use an explicit credentials:write account bearer grant or a live email-verified application session, plus the current account password as fresh identity proof. Cookie writes require a trusted Origin. Machine callers cannot issue scopes beyond their own grant or outlive it. Creation and rotation return the secret once; metadata never includes it. Scope and expiry can only be narrowed. Issued credentials expire within 24 hours and no later than their issuer session; session revocation invalidates them.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["credentials:write"],"parameters":[{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Origin","in":"header","required":false,"description":"Required for cookie authentication: an exact trusted application origin configured by the server. Bearer requests do not require Origin.","schema":{"type":"string","format":"uri"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialProof"}}}},"responses":{"201":{"description":"Replace a credential atomically without expanding its authority","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCredentialReceipt"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"404":{"description":"Credential not found in the authenticated user account."},"409":{"description":"Credential is inactive, already rotated, or requested scopes or expiry exceed its existing authority."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Identity service or freshly issued session unavailable."}}}},"/workspaces":{"get":{"operationId":"listWorkspaces","summary":"List workspaces of the authenticated user","tags":["Workspaces"],"description":"Use a user-bound `ca_` bearer credential with the stated account scope, or an application session. Workspace `ck_` keys and their OAuth tokens do not grant account authority.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:read"],"responses":{"200":{"description":"List workspaces of the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceList"}}}},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"500":{"description":"Unexpected server failure."}}},"post":{"operationId":"createWorkspace","summary":"Create a workspace owned by the authenticated user","tags":["Workspaces"],"description":"Use a user-bound `ca_` bearer credential with the stated account scope, or an application session. Workspace `ck_` keys and their OAuth tokens do not grant account authority.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceCreate"}}}},"responses":{"201":{"description":"Create a workspace owned by the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"409":{"description":"A workspace with this name already exists for the authenticated user."},"500":{"description":"Unexpected server failure."}}}},"/account/preferences":{"get":{"operationId":"getAccountPreferences","summary":"Read preferences that follow the authenticated user across workspaces","tags":["Account preferences"],"description":"Use a user-bound `ca_` bearer credential with the stated account scope, or an application session. Workspace `ck_` keys and their OAuth tokens do not grant account authority.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"responses":{"200":{"description":"Read preferences that follow the authenticated user across workspaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPreferences"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."}}},"patch":{"operationId":"updateAccountPreferences","summary":"Save preferences that follow the authenticated user across workspaces","tags":["Account preferences"],"description":"Use a user-bound `ca_` bearer credential with the stated account scope, or an application session. Workspace `ck_` keys and their OAuth tokens do not grant account authority.","security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPreferences"}}}},"responses":{"200":{"description":"Save preferences that follow the authenticated user across workspaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPreferences"}}},"headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store"}}}},"400":{"description":"Invalid request body or pagination."},"401":{"description":"Session or credential missing, invalid, expired or revoked; fresh password proof failed when required."},"403":{"description":"Email verification, trusted origin or required account scope is missing."},"429":{"description":"Per-user list or password proof rate limit exceeded."},"500":{"description":"Unexpected server failure."}}}},"/workspaces/{workspaceId}/contacts":{"post":{"operationId":"createContact","summary":"Create a standalone workspace contact; restricted-agent members cannot create unscoped profiles","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createContactRequest"}}}},"responses":{"201":{"description":"Create a standalone workspace contact; restricted-agent members cannot create unscoped profiles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createContactResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"listContacts","summary":"Search and page accessible contact profiles without hidden-agent totals","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000}},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Search and page accessible contact profiles without hidden-agent totals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listContactsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/contacts/{contactId}":{"delete":{"operationId":"removeContact","summary":"Remove a directory profile while retaining historical conversations; this is not full personal-data erasure","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"contactId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a directory profile while retaining historical conversations; this is not full personal-data erasure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/removeContactResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"readContactProfile","summary":"Read a contact profile and only the conversations visible to this member","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"contactId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read a contact profile and only the conversations visible to this member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readContactProfileResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"updateContactProfile","summary":"Edit supplied contact fields; restricted members cannot edit profiles shared with inaccessible agents","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"contactId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateContactProfileRequest"}}}},"responses":{"200":{"description":"Edit supplied contact fields; restricted members cannot edit profiles shared with inaccessible agents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateContactProfileResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/support-requests/live":{"get":{"operationId":"listInboxLiveSupportRequests","summary":"List support requests still live on a conversation; each needs a disposition before the conversation can close","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List support requests still live on a conversation; each needs a disposition before the conversation can close","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listInboxLiveSupportRequestsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/copilot":{"post":{"operationId":"requestInboxCopilotSuggestion","summary":"Draft, summarise, answer or translate a supplied draft without sending; translation requires text and targetLanguage and spends workspace credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/requestInboxCopilotSuggestionRequest"}}}},"responses":{"200":{"description":"Draft, summarise, answer or translate a supplied draft without sending; translation requires text and targetLanguage and spends workspace credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/requestInboxCopilotSuggestionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/copilot/endorse":{"post":{"operationId":"endorseInboxCopilotLearning","summary":"Record that a teammate used a learning-backed copilot suggestion","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/endorseInboxCopilotLearningRequest"}}}},"responses":{"200":{"description":"Record that a teammate used a learning-backed copilot suggestion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/endorseInboxCopilotLearningResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/attachments/presign":{"post":{"operationId":"presignInboxAttachment","summary":"Stage a reply attachment and return a short-lived upload URL; the file is not usable until confirmed","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignInboxAttachmentRequest"}}}},"responses":{"200":{"description":"Stage a reply attachment and return a short-lived upload URL; the file is not usable until confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignInboxAttachmentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/attachments/confirm":{"post":{"operationId":"confirmInboxAttachment","summary":"Verify and scan an uploaded attachment so a reply can include it","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmInboxAttachmentRequest"}}}},"responses":{"200":{"description":"Verify and scan an uploaded attachment so a reply can include it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmInboxAttachmentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/attachments/{attachmentId}/url":{"get":{"operationId":"readInboxAttachmentUrl","summary":"Return a short-lived download URL for an attachment on this conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Return a short-lived download URL for an attachment on this conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readInboxAttachmentUrlResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/messages/{messageId}/retry":{"post":{"operationId":"retryInboxReply","summary":"Re-queue a failed or uncertain reply; uncertain delivery requires confirmDuplicateRisk","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/retryInboxReplyRequest"}}}},"responses":{"200":{"description":"Re-queue a failed or uncertain reply; uncertain delivery requires confirmDuplicateRisk","content":{"application/json":{"schema":{"$ref":"#/components/schemas/retryInboxReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/merge":{"post":{"operationId":"mergeSupportRequests","summary":"Merge duplicate support requests at their expected versions","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/mergeSupportRequestsRequest"}}}},"responses":{"200":{"description":"Merge duplicate support requests at their expected versions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/mergeSupportRequestsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/split":{"post":{"operationId":"splitSupportRequest","summary":"Split a support request into separate goals by message","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/splitSupportRequestRequest"}}}},"responses":{"200":{"description":"Split a support request into separate goals by message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/splitSupportRequestResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/transitions":{"post":{"operationId":"transitionSupportRequest","summary":"Activate, wait, end or reopen a support request at its expected version","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/transitionSupportRequestRequest"}}}},"responses":{"200":{"description":"Activate, wait, end or reopen a support request at its expected version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/transitionSupportRequestResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/evidence":{"post":{"operationId":"appendSupportRequestEvidence","summary":"Attach a verified resolution receipt to a support request","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/appendSupportRequestEvidenceRequest"}}}},"responses":{"200":{"description":"Attach a verified resolution receipt to a support request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/appendSupportRequestEvidenceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/sla/bind":{"post":{"operationId":"bindSupportRequestSla","summary":"Bind the matching SLA policy to a support request","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/bindSupportRequestSlaRequest"}}}},"responses":{"200":{"description":"Bind the matching SLA policy to a support request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/bindSupportRequestSlaResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/sla/milestones":{"post":{"operationId":"recordSupportRequestSlaMilestone","summary":"Record an SLA milestone for a support request reply","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/recordSupportRequestSlaMilestoneRequest"}}}},"responses":{"200":{"description":"Record an SLA milestone for a support request reply","content":{"application/json":{"schema":{"$ref":"#/components/schemas/recordSupportRequestSlaMilestoneResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/sla/clocks/{kind}":{"get":{"operationId":"readSupportRequestSlaClock","summary":"Read one SLA clock for a support request","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["first_response","next_response","handoff_pickup","approval_review","verified_resolution"]}},{"name":"asOf","in":"query","required":false,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}],"responses":{"200":{"description":"Read one SLA clock for a support request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readSupportRequestSlaClockResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/labels":{"get":{"operationId":"listWorkspaceLabels","summary":"List the workspace labels conversations can carry","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List the workspace labels conversations can carry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWorkspaceLabelsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createWorkspaceLabel","summary":"Create a workspace label with a hex color or color token name","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWorkspaceLabelRequest"}}}},"responses":{"201":{"description":"Create a workspace label with a hex color or color token name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWorkspaceLabelResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/labels/{labelId}":{"patch":{"operationId":"updateWorkspaceLabel","summary":"Rename or recolor a workspace label","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceLabelRequest"}}}},"responses":{"200":{"description":"Rename or recolor a workspace label","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceLabelResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteWorkspaceLabel","summary":"Delete a workspace label and remove it from every conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Delete a workspace label and remove it from every conversation"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/labels/{labelId}":{"post":{"operationId":"attachInboxLabel","summary":"Attach a workspace label to a conversation; repeating it is a no-op","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Attach a workspace label to a conversation; repeating it is a no-op"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"detachInboxLabel","summary":"Detach a label from a conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Detach a label from a conversation"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/notes":{"post":{"operationId":"createInboxNote","summary":"Add an internal team note to a conversation; visitors never see it","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createInboxNoteRequest"}}}},"responses":{"201":{"description":"Add an internal team note to a conversation; visitors never see it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createInboxNoteResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/read":{"post":{"operationId":"markInboxConversationRead","summary":"Mark the caller's conversation read through the latest committed message or mention; other members are unchanged","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Mark the caller's conversation read through the latest committed message or mention; other members are unchanged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/markInboxConversationReadResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}":{"get":{"operationId":"readInboxConversation","summary":"Read a complete accessible ticket thread without marking it seen","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read a complete accessible ticket thread without marking it seen","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readInboxConversationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"updateInboxConversation","summary":"Update ticket status, routing and handling; active support requests require explicit dispositions before closure","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateInboxConversationRequest"}}}},"responses":{"200":{"description":"Update ticket status, routing and handling; active support requests require explicit dispositions before closure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateInboxConversationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/messages/{messageId}":{"patch":{"operationId":"editInboxReply","summary":"Edit an owned reply using its current lifecycle version","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/editInboxReplyRequest"}}}},"responses":{"200":{"description":"Edit an owned reply using its current lifecycle version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/editInboxReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/messages/{messageId}/undo":{"post":{"operationId":"undoInboxReply","summary":"Undo an owned queued reply before its undo deadline","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Undo an owned queued reply before its undo deadline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/undoInboxReplyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/{conversationId}/messages":{"post":{"operationId":"sendInboxReply","summary":"Queue a human reply using a stable message ID; acceptance does not prove delivery","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendInboxReplyRequest"}}}},"responses":{"201":{"description":"Queue a human reply using a stable message ID; acceptance does not prove delivery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendInboxReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox":{"get":{"operationId":"listInboxConversations","summary":"List accessible inbox conversations with existing folder and status filters","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["open","snoozed","closed","spam"]}},{"name":"folder","in":"query","required":false,"schema":{"type":"string","enum":["mentions","spam","team","created-by-you","unseen"]}},{"name":"teamId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"unseen","in":"query","required":false,"schema":{"type":"string","const":"1"}}],"responses":{"200":{"description":"List accessible inbox conversations with existing folder and status filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listInboxConversationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/inbox/counts":{"get":{"operationId":"readInboxCounts","summary":"Read accessible inbox folder counts and pending delivery summaries","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Inbox"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read accessible inbox folder counts and pending delivery summaries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readInboxCountsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations":{"get":{"operationId":"listLinkedConversations","summary":"List conversations on agents shared with this workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List conversations on agents shared with this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listLinkedConversationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/counts":{"get":{"operationId":"countLinkedConversations","summary":"Count linked conversations by status","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Count linked conversations by status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/countLinkedConversationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}":{"get":{"operationId":"readLinkedConversation","summary":"Read one linked conversation with its messages","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read one linked conversation with its messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedConversationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"setLinkedConversationStatus","summary":"Open, close, snooze or mark a linked conversation spam","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedConversationStatusRequest"}}}},"responses":{"200":{"description":"Open, close, snooze or mark a linked conversation spam","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedConversationStatusResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/read":{"post":{"operationId":"markLinkedConversationRead","summary":"Mark a linked conversation read for the caller","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Mark a linked conversation read for the caller","content":{"application/json":{"schema":{"$ref":"#/components/schemas/markLinkedConversationReadResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/copilot":{"post":{"operationId":"requestLinkedCopilotSuggestion","summary":"Draft, summarise or answer from a linked thread without sending anything; spends workspace credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/requestLinkedCopilotSuggestionRequest"}}}},"responses":{"200":{"description":"Draft, summarise or answer from a linked thread without sending anything; spends workspace credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/requestLinkedCopilotSuggestionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/copilot/endorse":{"post":{"operationId":"endorseLinkedCopilotLearning","summary":"Record that a teammate used a learning-backed copilot suggestion in a linked thread","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/endorseLinkedCopilotLearningRequest"}}}},"responses":{"200":{"description":"Record that a teammate used a learning-backed copilot suggestion in a linked thread","content":{"application/json":{"schema":{"$ref":"#/components/schemas/endorseLinkedCopilotLearningResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/attachments/presign":{"post":{"operationId":"presignLinkedAttachment","summary":"Stage a linked reply attachment and return a short-lived upload URL; unusable until confirmed","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignLinkedAttachmentRequest"}}}},"responses":{"200":{"description":"Stage a linked reply attachment and return a short-lived upload URL; unusable until confirmed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignLinkedAttachmentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/attachments/confirm":{"post":{"operationId":"confirmLinkedAttachment","summary":"Verify and scan an uploaded linked reply attachment","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmLinkedAttachmentRequest"}}}},"responses":{"200":{"description":"Verify and scan an uploaded linked reply attachment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmLinkedAttachmentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/attachments/{attachmentId}/url":{"get":{"operationId":"readLinkedAttachmentUrl","summary":"Return a short-lived download URL for an attachment on a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Return a short-lived download URL for an attachment on a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedAttachmentUrlResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/messages":{"post":{"operationId":"sendLinkedConversationReply","summary":"Send a teammate reply in a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendLinkedConversationReplyRequest"}}}},"responses":{"201":{"description":"Send a teammate reply in a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendLinkedConversationReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/messages/{messageId}/undo":{"post":{"operationId":"undoLinkedConversationReply","summary":"Undo a queued linked reply before it sends","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Undo a queued linked reply before it sends","content":{"application/json":{"schema":{"$ref":"#/components/schemas/undoLinkedConversationReplyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/messages/{messageId}":{"patch":{"operationId":"editLinkedConversationReply","summary":"Edit a queued linked reply","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/editLinkedConversationReplyRequest"}}}},"responses":{"200":{"description":"Edit a queued linked reply","content":{"application/json":{"schema":{"$ref":"#/components/schemas/editLinkedConversationReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/messages/{messageId}/retry":{"post":{"operationId":"retryLinkedConversationReply","summary":"Retry a failed linked reply","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/retryLinkedConversationReplyRequest"}}}},"responses":{"200":{"description":"Retry a failed linked reply","content":{"application/json":{"schema":{"$ref":"#/components/schemas/retryLinkedConversationReplyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/notes":{"post":{"operationId":"addLinkedConversationNote","summary":"Add an internal note to a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/addLinkedConversationNoteRequest"}}}},"responses":{"201":{"description":"Add an internal note to a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addLinkedConversationNoteResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/labels/{labelId}":{"post":{"operationId":"addLinkedConversationLabel","summary":"Add a source label to a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Add a source label to a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addLinkedConversationLabelResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"removeLinkedConversationLabel","summary":"Remove a source label from a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a source label from a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/removeLinkedConversationLabelResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/assign":{"post":{"operationId":"assignLinkedConversation","summary":"Assign a linked conversation to the caller or a teammate","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/assignLinkedConversationRequest"}}}},"responses":{"200":{"description":"Assign a linked conversation to the caller or a teammate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/assignLinkedConversationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/takeover":{"post":{"operationId":"takeOverLinkedConversation","summary":"Take a linked conversation over from the AI","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Take a linked conversation over from the AI","content":{"application/json":{"schema":{"$ref":"#/components/schemas/takeOverLinkedConversationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-conversations/{conversationId}/actions/{actionId}/run":{"post":{"operationId":"runLinkedConversationAction","summary":"Run an allowed action in a linked conversation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"actionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/runLinkedConversationActionRequest"}}}},"responses":{"200":{"description":"Run an allowed action in a linked conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/runLinkedConversationActionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/conversations":{"get":{"operationId":"listConversations","summary":"List conversations, optionally for one agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List conversations, optionally for one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listConversationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"startConversation","summary":"Start a conversation with a contact and send the first message","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/startConversationRequest"}}}},"responses":{"201":{"description":"Start a conversation with a contact and send the first message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startConversationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/conversations/{conversationId}":{"get":{"operationId":"readConversation","summary":"Read one conversation with its messages","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read one conversation with its messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readConversationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"setConversationStatus","summary":"Open or close a conversation; active support requests need dispositions or force","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["inbox:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setConversationStatusRequest"}}}},"responses":{"200":{"description":"Open or close a conversation; active support requests need dispositions or force","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setConversationStatusResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}":{"get":{"operationId":"readWorkspace","summary":"Read a workspace of the authenticated member","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read a workspace of the authenticated member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readWorkspaceResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"updateWorkspace","summary":"Rename a workspace or change its timezone","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceRequest"}}}},"responses":{"200":{"description":"Rename a workspace or change its timezone","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Duplicate workspace name, conflicting invitation, used invitation, active billing or open checkout prevents this operation."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteWorkspace","summary":"Delete an owned workspace with its name as confirmation","description":"Requires explicit workspaces:manage scope and the live owner role. Echo the current workspace name. Active paid access or an open checkout blocks deletion; existing cleanup and credit-grant protections remain active.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteWorkspaceRequest"}}}},"responses":{"204":{"description":"Delete an owned workspace with its name as confirmation"},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Duplicate workspace name, conflicting invitation, used invitation, active billing or open checkout prevents this operation."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members":{"get":{"operationId":"listWorkspaceMembers","summary":"List workspace members and identities","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List workspace members and identities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWorkspaceMembersResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"addWorkspaceMember","summary":"Add a user to a workspace with any role except owner","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/addWorkspaceMemberRequest"}}}},"responses":{"201":{"description":"Add a user to a workspace with any role except owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addWorkspaceMemberResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members/{memberId}":{"patch":{"operationId":"updateWorkspaceMemberRole","summary":"Change a non-owner workspace member role","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceMemberRoleRequest"}}}},"responses":{"200":{"description":"Change a non-owner workspace member role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWorkspaceMemberRoleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"removeWorkspaceMember","summary":"Remove a non-owner workspace member","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a non-owner workspace member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/removeWorkspaceMemberResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members/invites":{"get":{"operationId":"listWorkspaceInvites","summary":"List workspace invitations","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List workspace invitations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWorkspaceInvitesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createWorkspaceInvite","summary":"Invite someone to a workspace with any role except owner","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWorkspaceInviteRequest"}}}},"responses":{"201":{"description":"Invite someone to a workspace with any role except owner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWorkspaceInviteResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Duplicate workspace name, conflicting invitation, used invitation, active billing or open checkout prevents this operation."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members/invites/{inviteId}/resend":{"post":{"operationId":"resendWorkspaceInvite","summary":"Resend or reactivate an invitation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"inviteId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Resend or reactivate an invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/resendWorkspaceInviteResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Duplicate workspace name, conflicting invitation, used invitation, active billing or open checkout prevents this operation."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members/invites/{inviteId}":{"delete":{"operationId":"cancelWorkspaceInvite","summary":"Remove a workspace invitation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"inviteId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a workspace invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelWorkspaceInviteResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/invites/{token}/accept":{"post":{"operationId":"acceptWorkspaceInvite","summary":"Accept an invitation for the verified account email","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspace members"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["invites:accept"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Accept an invitation for the verified account email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/acceptWorkspaceInviteResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Duplicate workspace name, conflicting invitation, used invitation, active billing or open checkout prevents this operation."},"410":{"description":"Invitation has expired."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/members/{memberId}/agents":{"get":{"operationId":"readMemberAgentAccess","summary":"Read a member agent allow-list","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read a member agent allow-list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readMemberAgentAccessResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"put":{"operationId":"updateMemberAgentAccess","summary":"Replace a member agent allow-list","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["members:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateMemberAgentAccessRequest"}}}},"responses":{"200":{"description":"Replace a member agent allow-list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateMemberAgentAccessResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/teams":{"get":{"operationId":"listTeams","summary":"List workspace teams and memberships","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List workspace teams and memberships","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listTeamsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createTeam","summary":"Create a workspace team","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createTeamRequest"}}}},"responses":{"201":{"description":"Create a workspace team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createTeamResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/teams/{teamId}":{"patch":{"operationId":"updateTeam","summary":"Rename a workspace team","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"teamId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateTeamRequest"}}}},"responses":{"200":{"description":"Rename a workspace team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateTeamResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteTeam","summary":"Delete a workspace team","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"teamId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Delete a workspace team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteTeamResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/teams/{teamId}/members":{"post":{"operationId":"addTeamMember","summary":"Add a workspace member to a team","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"teamId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/addTeamMemberRequest"}}}},"responses":{"201":{"description":"Add a workspace member to a team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/addTeamMemberResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/teams/{teamId}/members/{memberId}":{"delete":{"operationId":"removeTeamMember","summary":"Remove a member from a team","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Teams"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["teams:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"teamId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a member from a team","content":{"application/json":{"schema":{"$ref":"#/components/schemas/removeTeamMemberResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement or seat capacity does not allow the operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/custom-domains":{"get":{"operationId":"listCustomDomains","summary":"List custom domains with the DNS records each still needs","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List custom domains with the DNS records each still needs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listCustomDomainsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createCustomDomain","summary":"Register a custom domain for an agent on a paid workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createCustomDomainRequest"}}}},"responses":{"201":{"description":"Register a custom domain for an agent on a paid workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createCustomDomainResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/custom-domains/{domainId}/verify":{"post":{"operationId":"verifyCustomDomain","summary":"Check DNS now and mark the custom domain verified when it matches","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Check DNS now and mark the custom domain verified when it matches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/verifyCustomDomainResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/custom-domains/{domainId}":{"delete":{"operationId":"removeCustomDomain","summary":"Remove a custom domain; one that ever served traffic is parked until DNS moves away","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a custom domain; one that ever served traffic is parked until DNS moves away","content":{"application/json":{"schema":{"$ref":"#/components/schemas/removeCustomDomainResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/webhooks":{"get":{"operationId":"listWebhooks","summary":"List workspace webhooks without their signing secrets","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List workspace webhooks without their signing secrets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWebhooksResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createWebhook","summary":"Create a webhook; the signing secret is returned once","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWebhookRequest"}}}},"responses":{"201":{"description":"Create a webhook; the signing secret is returned once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createWebhookResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/webhooks/{webhookId}":{"patch":{"operationId":"updateWebhook","summary":"Pause, resume or change the events of a webhook","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWebhookRequest"}}}},"responses":{"200":{"description":"Pause, resume or change the events of a webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWebhookResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteWebhook","summary":"Delete a webhook","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["workspaces:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Delete a webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteWebhookResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/analytics":{"get":{"operationId":"readWorkspaceAnalytics","summary":"Read workspace conversation analytics for the last N days","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}}],"responses":{"200":{"description":"Read workspace conversation analytics for the last N days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readWorkspaceAnalyticsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/analytics/agents/{agentId}":{"get":{"operationId":"readAgentAnalytics","summary":"Read one agent analytics for the last N days","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}}],"responses":{"200":{"description":"Read one agent analytics for the last N days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/analytics/insights":{"get":{"operationId":"readAgentInsights","summary":"Read cached topic and sentiment insights for one agent; never spends credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}},{"name":"agentId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read cached topic and sentiment insights for one agent; never spends credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentInsightsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing":{"get":{"operationId":"readBilling","summary":"Read the workspace billing overview the caller may see","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the workspace billing overview the caller may see","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readBillingResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/purchases":{"get":{"operationId":"readBillingPurchases","summary":"Read whether the workspace has bought before, for checkout copy","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read whether the workspace has bought before, for checkout copy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readBillingPurchasesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/usage":{"get":{"operationId":"readBillingUsage","summary":"Read credit usage for a date range","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"range","in":"query","required":false,"schema":{"type":"string","enum":["7d","30d","90d","all","custom"]}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Read credit usage for a date range","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readBillingUsageResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-analytics":{"get":{"operationId":"readLinkedAnalytics","summary":"Read conversation analytics for agents shared with this workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}},{"name":"grantId","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read conversation analytics for agents shared with this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedAnalyticsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-analytics/insights":{"get":{"operationId":"readLinkedInsights","summary":"Read cached insights for a linked agent; never spends credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":365}},{"name":"grantId","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read cached insights for a linked agent; never spends credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedInsightsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/summary":{"get":{"operationId":"readAgentAnalyticsSummary","summary":"Read the analytics summary for one agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the analytics summary for one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsSummaryResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/surface":{"get":{"operationId":"readAgentAnalyticsSurface","summary":"Read which analytics views are available for one agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read which analytics views are available for one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsSurfaceResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/reports/{report}":{"get":{"operationId":"readAgentAnalyticsReport","summary":"Read one analytics report for one agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"report","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read one analytics report for one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsReportResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/classification/policy":{"get":{"operationId":"readAgentClassificationPolicy","summary":"Read the topic classification policy for one agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the topic classification policy for one agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentClassificationPolicyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"put":{"operationId":"setClassificationPolicy","summary":"Set how conversations are classified for analytics","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Set how conversations are classified for analytics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setClassificationPolicyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/classification/jobs/{jobId}":{"get":{"operationId":"readAgentClassificationJob","summary":"Read the status of one topic classification job","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the status of one topic classification job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentClassificationJobResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/exports/{artifactId}":{"get":{"operationId":"readAgentAnalyticsExport","summary":"Read the status of one analytics export","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"artifactId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the status of one analytics export","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsExportResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/drilldown":{"get":{"operationId":"readAgentAnalyticsDrilldown","summary":"Read the conversations behind an agent analytics view","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:read"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the conversations behind an agent analytics view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentAnalyticsDrilldownResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/source-suggestions":{"get":{"operationId":"readSourceSuggestions","summary":"Review source health and coverage gaps, including sampled visitor questions","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["learnings:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Review source health and coverage gaps, including sampled visitor questions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readSourceSuggestionsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/models":{"get":{"operationId":"listAgentModels","summary":"List available models and workspace plan eligibility","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List available models and workspace plan eligibility","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentModelsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents":{"get":{"operationId":"listWorkspaceAgents","summary":"List accessible workspace agents and activity counts","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List accessible workspace agents and activity counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWorkspaceAgentsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createAgent","summary":"Create an agent with explicit settings","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentRequest"}}}},"responses":{"201":{"description":"Create an agent with explicit settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/help-center/articles":{"get":{"operationId":"listHelpArticles","summary":"List help-center articles for an agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List help-center articles for an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listHelpArticlesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createHelpArticle","summary":"Write a help-center article","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createHelpArticleRequest"}}}},"responses":{"201":{"description":"Write a help-center article","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createHelpArticleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/help-center/articles/{articleId}":{"patch":{"operationId":"updateHelpArticle","summary":"Edit a help-center article","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"articleId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateHelpArticleRequest"}}}},"responses":{"200":{"description":"Edit a help-center article","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateHelpArticleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteHelpArticle","summary":"Delete a help-center article and untrain it","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:delete"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"articleId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Delete a help-center article and untrain it"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grants":{"get":{"operationId":"listAgentGrants","summary":"List the workspaces this agent is shared with","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List the workspaces this agent is shared with","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentGrantsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createAgentGrant","summary":"Share this agent with another workspace by email","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentGrantRequest"}}}},"responses":{"201":{"description":"Share this agent with another workspace by email","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentGrantResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}":{"get":{"operationId":"readAgent","summary":"Read an accessible agent and its settings","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read an accessible agent and its settings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"put":{"operationId":"updateAgent","summary":"Update supplied agent settings; supplied nested configurations replace their saved object","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentRequest"}}}},"responses":{"200":{"description":"Update supplied agent settings; supplied nested configurations replace their saved object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/setup":{"get":{"operationId":"readAgentSetup","summary":"Read actual agent setup completion","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read actual agent setup completion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentSetupResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/logo/fetch":{"post":{"operationId":"fetchAgentLogo","summary":"Set the agent logo from a website favicon (the supplied website or the saved one)","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/fetchAgentLogoRequest"}}}},"responses":{"200":{"description":"Set the agent logo from a website favicon (the supplied website or the saved one)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/fetchAgentLogoResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/voice/catalog":{"get":{"operationId":"readVoiceCatalog","summary":"List available voice options and whether voice runtime is enabled","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List available voice options and whether voice runtime is enabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readVoiceCatalogResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/contacts":{"get":{"operationId":"listAgentContacts","summary":"List the distinct widget visitors who have talked to an agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List the distinct widget visitors who have talked to an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentContactsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/chat":{"post":{"operationId":"chatWithAgentPreview","summary":"Send a playground test message to an agent; spends workspace credits like any chat","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/chatWithAgentPreviewRequest"}}}},"responses":{"200":{"description":"Send a playground test message to an agent; spends workspace credits like any chat","content":{"application/json":{"schema":{"$ref":"#/components/schemas/chatWithAgentPreviewResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/duplicate":{"post":{"operationId":"duplicateAgent","summary":"Duplicate an agent configuration and training sources as a draft","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Duplicate an agent configuration and training sources as a draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duplicateAgentResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources":{"post":{"operationId":"createSource","summary":"Train text or Q&A immediately, or enqueue durable website/blog ingestion","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createSourceRequest"}}}},"responses":{"201":{"description":"Train text or Q&A immediately, or enqueue durable website/blog ingestion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createSourceResponse"}}}},"202":{"description":"Train text or Q&A immediately, or enqueue durable website/blog ingestion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"listSources","summary":"List source readiness, metadata, queue state and chunk counts","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List source readiness, metadata, queue state and chunk counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listSourcesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}":{"get":{"operationId":"readSourceContent","summary":"Read owned source content and its current revision","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read owned source content and its current revision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readSourceContentResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"patch":{"operationId":"updateSourceContent","summary":"Replace source title or editable content using its current revision","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateSourceContentRequest"}}}},"responses":{"200":{"description":"Replace source title or editable content using its current revision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateSourceContentResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteSource","summary":"Remove a source and its indexed knowledge","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a source and its indexed knowledge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteSourceResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources/file":{"post":{"operationId":"uploadSourceFile","summary":"Upload and extract a knowledge document up to 10 MB","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/uploadSourceFileRequest"}}}},"responses":{"201":{"description":"Upload and extract a knowledge document up to 10 MB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/uploadSourceFileResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"413":{"description":"The uploaded document exceeds 10 MB."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/recrawl":{"post":{"operationId":"recrawlSource","summary":"Queue a website or blog source recrawl while preserving prior knowledge until success","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"202":{"description":"Queue a website or blog source recrawl while preserving prior knowledge until success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/recrawlSourceResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/refresh":{"patch":{"operationId":"updateSourceRefresh","summary":"Enable or disable scheduled website or blog refresh","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateSourceRefreshRequest"}}}},"responses":{"200":{"description":"Enable or disable scheduled website or blog refresh","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateSourceRefreshResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/sources/{sourceId}/pages":{"delete":{"operationId":"deleteSourcePage","summary":"Remove one crawled page from a website or blog source and its indexed chunks","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["sources:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove one crawled page from a website or blog source and its indexed chunks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteSourcePageResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/macros":{"get":{"operationId":"listAgentMacros","summary":"List saved replies for an agent with this month's use counts","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List saved replies for an agent with this month's use counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentMacrosResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createAgentMacro","summary":"Create a saved reply; names are unique per agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentMacroRequest"}}}},"responses":{"201":{"description":"Create a saved reply; names are unique per agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentMacroResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/macros/{macroId}":{"patch":{"operationId":"updateAgentMacro","summary":"Update supplied saved reply fields","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"macroId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentMacroRequest"}}}},"responses":{"200":{"description":"Update supplied saved reply fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentMacroResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteAgentMacro","summary":"Delete a saved reply","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"macroId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Delete a saved reply"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/macros/{macroId}/uses":{"post":{"operationId":"recordAgentMacroUse","summary":"Record that the caller inserted a saved reply","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"macroId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Record that the caller inserted a saved reply"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules":{"get":{"operationId":"listAgentRules","summary":"List an agent's automation rules in run order with weekly fire counts","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List an agent's automation rules in run order with weekly fire counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentRulesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createAgentRule","summary":"Create an automation rule at the end of the run order","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentRuleRequest"}}}},"responses":{"201":{"description":"Create an automation rule at the end of the run order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentRuleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules/{ruleId}":{"patch":{"operationId":"updateAgentRule","summary":"Update supplied automation rule fields","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentRuleRequest"}}}},"responses":{"200":{"description":"Update supplied automation rule fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentRuleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteAgentRule","summary":"Delete an automation rule","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Delete an automation rule"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules/order":{"put":{"operationId":"reorderAgentRules","summary":"Set the run order; send every rule of the agent exactly once","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/reorderAgentRulesRequest"}}}},"responses":{"204":{"description":"Set the run order; send every rule of the agent exactly once"},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules/loop-guard":{"put":{"operationId":"setAgentRuleLoopGuard","summary":"Turn the automation loop guard on or off","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAgentRuleLoopGuardRequest"}}}},"responses":{"200":{"description":"Turn the automation loop guard on or off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAgentRuleLoopGuardResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules/runs":{"get":{"operationId":"listAgentRuleRuns","summary":"List the 50 latest rule fires, newest first","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List the 50 latest rule fires, newest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listAgentRuleRunsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/rules/preview":{"post":{"operationId":"previewAgentRule","summary":"Dry-run rule conditions against recent conversations without applying them","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewAgentRuleRequest"}}}},"responses":{"200":{"description":"Dry-run rule conditions against recent conversations without applying them","content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewAgentRuleResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/settings":{"get":{"operationId":"readAgentSupportSettings","summary":"Read assignment, hours, reply targets, email handling, the caller signature and the support mailbox","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read assignment, hours, reply targets, email handling, the caller signature and the support mailbox","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readAgentSupportSettingsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"put":{"operationId":"updateAgentSupportSettings","summary":"Replace support settings; the stored loop guard is kept when automation is omitted","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentSupportSettingsRequest"}}}},"responses":{"200":{"description":"Replace support settings; the stored loop guard is kept when automation is omitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentSupportSettingsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/signature":{"put":{"operationId":"setAgentSupportSignature","summary":"Set or clear the caller own email signature for this agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAgentSupportSignatureRequest"}}}},"responses":{"200":{"description":"Set or clear the caller own email signature for this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAgentSupportSignatureResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents":{"get":{"operationId":"listLinkedAgents","summary":"List agents other workspaces share with this workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List agents other workspaces share with this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listLinkedAgentsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}":{"get":{"operationId":"readLinkedAgent","summary":"Read one linked agent grant","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read one linked agent grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedAgentResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/settings":{"get":{"operationId":"readLinkedAgentSettings","summary":"Read the settings a Manage grant may change","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the settings a Manage grant may change","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readLinkedAgentSettingsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/actions":{"get":{"operationId":"listLinkedAgentActions","summary":"List actions on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List actions on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listLinkedAgentActionsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources":{"get":{"operationId":"listLinkedAgentSources","summary":"List sources on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List sources on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listLinkedAgentSourcesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createLinkedAgentSource","summary":"Add a text, Q&A, URL or blog source to a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createLinkedAgentSourceRequest"}}}},"responses":{"201":{"description":"Add a text, Q&A, URL or blog source to a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createLinkedAgentSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/settings/ai":{"patch":{"operationId":"setLinkedAgentAiSettings","summary":"Change prompt, model or temperature on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentAiSettingsRequest"}}}},"responses":{"200":{"description":"Change prompt, model or temperature on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentAiSettingsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/settings/widget":{"patch":{"operationId":"setLinkedAgentWidgetSettings","summary":"Change widget settings on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentWidgetSettingsRequest"}}}},"responses":{"200":{"description":"Change widget settings on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentWidgetSettingsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/settings/pause":{"patch":{"operationId":"setLinkedAgentPause","summary":"Pause or resume a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentPauseRequest"}}}},"responses":{"200":{"description":"Pause or resume a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setLinkedAgentPauseResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/actions/{actionId}":{"patch":{"operationId":"updateLinkedAgentAction","summary":"Edit an action on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"actionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateLinkedAgentActionRequest"}}}},"responses":{"200":{"description":"Edit an action on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateLinkedAgentActionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}":{"patch":{"operationId":"updateLinkedAgentSource","summary":"Edit a source on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateLinkedAgentSourceRequest"}}}},"responses":{"200":{"description":"Edit a source on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateLinkedAgentSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/retrain":{"post":{"operationId":"retrainLinkedAgentSource","summary":"Retrain a source on a Manage-linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/retrainLinkedAgentSourceRequest"}}}},"responses":{"200":{"description":"Retrain a source on a Manage-linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/retrainLinkedAgentSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/enable":{"post":{"operationId":"enableLinkedAgentSource","summary":"Turn on scheduled refresh for a linked source","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/enableLinkedAgentSourceRequest"}}}},"responses":{"200":{"description":"Turn on scheduled refresh for a linked source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/enableLinkedAgentSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/sources/{sourceId}/disable":{"post":{"operationId":"disableLinkedAgentSource","summary":"Turn off scheduled refresh for a linked source","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Sources"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/disableLinkedAgentSourceRequest"}}}},"responses":{"200":{"description":"Turn off scheduled refresh for a linked source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/disableLinkedAgentSourceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/unlink":{"post":{"operationId":"unlinkLinkedAgent","summary":"Remove a linked agent from this workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a linked agent from this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/unlinkLinkedAgentResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/member-assignments":{"post":{"operationId":"assignLinkedAgentMember","summary":"Give a teammate access to a linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/assignLinkedAgentMemberRequest"}}}},"responses":{"200":{"description":"Give a teammate access to a linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/assignLinkedAgentMemberResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-agents/{grantId}/member-assignments/{memberId}":{"delete":{"operationId":"unassignLinkedAgentMember","summary":"Remove a teammate from a linked agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Remove a teammate from a linked agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/unassignLinkedAgentMemberResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/learnings":{"get":{"operationId":"listLearnings","summary":"Review captured learning candidates and publication state","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Learnings"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["learnings:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Review captured learning candidates and publication state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listLearningsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/learnings/{learningId}/approve":{"post":{"operationId":"approveLearning","summary":"Approve captured knowledge using existing publication and conflict rules","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Learnings"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["learnings:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"learningId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Approve captured knowledge using existing publication and conflict rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/approveLearningResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/learnings/{learningId}/reject":{"post":{"operationId":"rejectLearning","summary":"Reject captured knowledge using existing terminal and conflict rules","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Learnings"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["learnings:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"learningId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Reject captured knowledge using existing terminal and conflict rules","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rejectLearningResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/active":{"get":{"operationId":"readActiveGrillRound","summary":"Resume the latest active training round or report no draft","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Resume the latest active training round or report no draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readActiveGrillRoundResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds":{"post":{"operationId":"createGrillRound","summary":"Generate a resumable training round and charge for its generated questions","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createGrillRoundRequest"}}}},"responses":{"201":{"description":"Generate a resumable training round and charge for its generated questions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createGrillRoundResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}":{"get":{"operationId":"readGrillRound","summary":"Read an addressed training round and its questions","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read an addressed training round and its questions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readGrillRoundResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/answer":{"post":{"operationId":"answerGrillQuestion","summary":"Save, edit or clear a training answer without charging credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/answerGrillQuestionRequest"}}}},"responses":{"200":{"description":"Save, edit or clear a training answer without charging credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/answerGrillQuestionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/draft":{"post":{"operationId":"draftGrillAnswer","summary":"Draft an answer from live retrieval and charge one credit without saving it","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Draft an answer from live retrieval and charge one credit without saving it","content":{"application/json":{"schema":{"$ref":"#/components/schemas/draftGrillAnswerResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/skip":{"post":{"operationId":"skipGrillQuestion","summary":"Skip a training question and charge only when a replacement is generated","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Skip a training question and charge only when a replacement is generated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/skipGrillQuestionResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/questions/{questionId}/regenerate":{"post":{"operationId":"regenerateGrillQuestion","summary":"Replace an unanswered training question and charge one credit","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"questionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Replace an unanswered training question and charge one credit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/regenerateGrillQuestionResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grill/rounds/{roundId}/finish":{"post":{"operationId":"finishGrillRound","summary":"Publish answered training pairs as indexed Q&A knowledge without charging credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Grill"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["grill:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"roundId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Publish answered training pairs as indexed Q&A knowledge without charging credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/finishGrillRoundResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/member-notifications/vapid-public-key":{"get":{"operationId":"readNotificationPublicKey","summary":"Read the configured public Push application key","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:read"],"parameters":[],"responses":{"200":{"description":"Read the configured public Push application key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readNotificationPublicKeyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/member-notifications/subscriptions":{"get":{"operationId":"listNotificationDevices","summary":"List owned notification devices without endpoint or key secrets","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:read"],"parameters":[],"responses":{"200":{"description":"List owned notification devices without endpoint or key secrets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listNotificationDevicesResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}},"post":{"operationId":"registerNotificationDevice","summary":"Register or rebind a Push subscription supplied by its device","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/registerNotificationDeviceRequest"}}}},"responses":{"200":{"description":"Register or rebind a Push subscription supplied by its device","content":{"application/json":{"schema":{"$ref":"#/components/schemas/registerNotificationDeviceResponse"}}}},"201":{"description":"Register or rebind a Push subscription supplied by its device","content":{"application/json":{"schema":{"$ref":"#/components/schemas/registerNotificationDeviceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/member-notifications/badge":{"get":{"operationId":"readNotificationBadge","summary":"Read the authenticated user notification badge count","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:read"],"parameters":[],"responses":{"200":{"description":"Read the authenticated user notification badge count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readNotificationBadgeResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/member-notifications/subscriptions/{subscriptionId}":{"patch":{"operationId":"renameNotificationDevice","summary":"Rename a notification device owned by the authenticated user","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/renameNotificationDeviceRequest"}}}},"responses":{"200":{"description":"Rename a notification device owned by the authenticated user","content":{"application/json":{"schema":{"$ref":"#/components/schemas/renameNotificationDeviceResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}},"delete":{"operationId":"deleteNotificationDevice","summary":"Remove an owned notification device and its dependent delivery state","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[{"name":"subscriptionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Remove an owned notification device and its dependent delivery state"},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/member-notifications":{"get":{"operationId":"readNotificationSettings","summary":"Read personal workspace notification settings and accessible devices and agents","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read personal workspace notification settings and accessible devices and agents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readNotificationSettingsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/member-notifications/preferences":{"patch":{"operationId":"updateNotificationSettings","summary":"Update personal notification settings using the current revision","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateNotificationSettingsRequest"}}}},"responses":{"200":{"description":"Update personal notification settings using the current revision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateNotificationSettingsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"The supplied settings revision is stale."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/member-notifications/visibility":{"post":{"operationId":"updateNotificationVisibility","summary":"Set or clear the short-lived visibility proof for an accessible conversation","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateNotificationVisibilityRequest"}}}},"responses":{"200":{"description":"Set or clear the short-lived visibility proof for an accessible conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateNotificationVisibilityResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/member-notifications/test":{"post":{"operationId":"sendNotificationTest","summary":"Send a content-free test to an owned enabled device; provider acceptance is not device delivery proof","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendNotificationTestRequest"}}}},"responses":{"200":{"description":"Send a content-free test to an owned enabled device; provider acceptance is not device delivery proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sendNotificationTestResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"The owned device requires attention."},"410":{"description":"The owned Push subscription expired."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/member-notifications/member-summary":{"get":{"operationId":"readNotificationMemberSummary","summary":"Read content-free member notification readiness as a live owner or admin","description":"Use an explicit notifications:read or notifications:write account grant, or an application session. Devices belong to the authenticated user; workspace settings retain live membership and agent access. Member summaries require the live owner/admin role. Cookie writes still require a trusted Origin. Provider acceptance alone does not establish device delivery.","tags":["Notifications"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["notifications:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read content-free member notification readiness as a live owner or admin","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readNotificationMemberSummaryResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"429":{"description":"Notification mutation or test rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Push is not configured or the provider is temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/actions":{"get":{"operationId":"listActions","summary":"List custom agent actions with credential headers redacted","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List custom agent actions with credential headers redacted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listActionsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createAction","summary":"Create a custom agent action","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createActionRequest"}}}},"responses":{"201":{"description":"Create a custom agent action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createActionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/actions/batch":{"post":{"operationId":"createActionsBatch","summary":"Atomically create up to twenty custom agent actions","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createActionsBatchRequest"}}}},"responses":{"201":{"description":"Atomically create up to twenty custom agent actions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createActionsBatchResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/actions/{actionId}":{"patch":{"operationId":"updateAction","summary":"Update a custom agent action while preserving omitted headers","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"actionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateActionRequest"}}}},"responses":{"200":{"description":"Update a custom agent action while preserving omitted headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateActionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteAction","summary":"Delete a custom agent action","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"actionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Delete a custom agent action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteActionResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/integrations/calendly/oauth/start":{"post":{"operationId":"startCalendlyAuthorization","summary":"Start agent-bound Calendly consent with PKCE; completion requires provider consent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Start agent-bound Calendly consent with PKCE; completion requires provider consent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startCalendlyAuthorizationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/integrations/calendly/oauth/complete":{"post":{"operationId":"completeCalendlyAuthorization","summary":"Exchange agent-bound Calendly consent and persist an encrypted scheduling connection","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/completeCalendlyAuthorizationRequest"}}}},"responses":{"201":{"description":"Exchange agent-bound Calendly consent and persist an encrypted scheduling connection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/completeCalendlyAuthorizationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/integrations":{"post":{"operationId":"createIntegration","summary":"Validate provider credentials and connect a scheduling integration","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createIntegrationRequest"}}}},"responses":{"201":{"description":"Validate provider credentials and connect a scheduling integration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createIntegrationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"listIntegrations","summary":"List provider capabilities and permitted Agent connections without credentials","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List provider capabilities and permitted Agent connections without credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listIntegrationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/integrations/{integrationId}":{"patch":{"operationId":"updateIntegration","summary":"Update integration enablement, capabilities and merged configuration","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateIntegrationRequest"}}}},"responses":{"200":{"description":"Update integration enablement, capabilities and merged configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateIntegrationResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteIntegration","summary":"Disconnect an agent integration and remove its unused credential connection","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Disconnect an agent integration and remove its unused credential connection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteIntegrationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/integrations/{integrationId}/test":{"post":{"operationId":"testIntegration","summary":"Revalidate stored provider credentials and update connection verification status","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"integrationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Revalidate stored provider credentials and update connection verification status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/testIntegrationResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/outbound-campaigns":{"get":{"operationId":"listOutboundCampaigns","summary":"List outbound campaigns for an agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List outbound campaigns for an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOutboundCampaignsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createOutboundCampaign","summary":"Create an outbound campaign draft","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createOutboundCampaignRequest"}}}},"responses":{"201":{"description":"Create an outbound campaign draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createOutboundCampaignResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/outbound-campaigns/{campaignId}/pause":{"post":{"operationId":"pauseOutboundCampaign","summary":"Pause a scheduled outbound campaign","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Pause a scheduled outbound campaign","content":{"application/json":{"schema":{"$ref":"#/components/schemas/pauseOutboundCampaignResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/outbound-campaigns/{campaignId}":{"delete":{"operationId":"deleteOutboundCampaign","summary":"Delete an outbound campaign after pausing if scheduled","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Delete an outbound campaign after pausing if scheduled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteOutboundCampaignResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app/images/presign":{"post":{"operationId":"presignInAppImage","summary":"Prepare an agent-owned in-app image upload","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignInAppImageRequest"}}}},"responses":{"200":{"description":"Prepare an agent-owned in-app image upload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/presignInAppImageResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app/images/confirm":{"post":{"operationId":"confirmInAppImage","summary":"Validate an uploaded agent-owned image and obtain its managed URL","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmInAppImageRequest"}}}},"responses":{"200":{"description":"Validate an uploaded agent-owned image and obtain its managed URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmInAppImageResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app":{"post":{"operationId":"createInAppCampaign","summary":"Create an in-app campaign with native authoring validation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createInAppCampaignRequest"}}}},"responses":{"201":{"description":"Create an in-app campaign with native authoring validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createInAppCampaignResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"listInAppCampaigns","summary":"List in-app campaigns for an agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List in-app campaigns for an agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listInAppCampaignsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app/{nudgeId}":{"patch":{"operationId":"updateInAppCampaign","summary":"Edit in-app campaign authoring fields in place","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"nudgeId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateInAppCampaignRequest"}}}},"responses":{"200":{"description":"Edit in-app campaign authoring fields in place","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateInAppCampaignResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"get":{"operationId":"getInAppCampaign","summary":"Read an in-app campaign and its stored authoring fields","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"nudgeId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read an in-app campaign and its stored authoring fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/getInAppCampaignResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"delete":{"operationId":"deleteInAppCampaign","summary":"Delete an untouched draft or archive a campaign with history","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"nudgeId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Delete an untouched draft or archive a campaign with history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteInAppCampaignResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app/{nudgeId}/analytics":{"get":{"operationId":"readInAppCampaignAnalytics","summary":"Read views, clicks and dismissals for one in-app campaign","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:read"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"nudgeId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read views, clicks and dismissals for one in-app campaign","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readInAppCampaignAnalyticsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/in-app/{nudgeId}/duplicate":{"post":{"operationId":"duplicateInAppCampaign","summary":"Copy an in-app campaign into a new draft","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"nudgeId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"201":{"description":"Copy an in-app campaign into a new draft","content":{"application/json":{"schema":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/deletion/request":{"post":{"operationId":"requestAgentDeletion","summary":"Email the workspace owner a 6-digit code to delete this agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:delete"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Email the workspace owner a 6-digit code to delete this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/requestAgentDeletionResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/deletion/confirm":{"post":{"operationId":"confirmAgentDeletion","summary":"Schedule agent deletion with the emailed 6-digit code","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:delete"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmAgentDeletionRequest"}}}},"responses":{"200":{"description":"Schedule agent deletion with the emailed 6-digit code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmAgentDeletionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/deletion/cancel":{"post":{"operationId":"cancelAgentDeletion","summary":"Cancel a scheduled agent deletion","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:delete"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Cancel a scheduled agent deletion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelAgentDeletionResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grants/{grantId}/permission":{"patch":{"operationId":"updateAgentGrantPermission","summary":"Change what a linked workspace may do with this agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentGrantPermissionRequest"}}}},"responses":{"200":{"description":"Change what a linked workspace may do with this agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateAgentGrantPermissionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grants/{grantId}/resend":{"post":{"operationId":"resendAgentGrant","summary":"Resend a pending share invitation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Resend a pending share invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/resendAgentGrantResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grants/{grantId}/cancel":{"post":{"operationId":"cancelAgentGrant","summary":"Cancel a pending share invitation","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Cancel a pending share invitation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelAgentGrantResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/grants/{grantId}/revoke":{"post":{"operationId":"revokeAgentGrant","summary":"Revoke an accepted share","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"grantId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Revoke an accepted share","content":{"application/json":{"schema":{"$ref":"#/components/schemas/revokeAgentGrantResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/linked-agent-grants/{token}/accept":{"post":{"operationId":"acceptLinkedAgentGrant","summary":"Accept a shared agent into one of your workspaces","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/acceptLinkedAgentGrantRequest"}}}},"responses":{"200":{"description":"Accept a shared agent into one of your workspaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/acceptLinkedAgentGrantResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/linked-agent-grants/{token}/decline":{"post":{"operationId":"declineLinkedAgentGrant","summary":"Decline a shared agent","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:share"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Decline a shared agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/declineLinkedAgentGrantResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/transfer/preview":{"get":{"operationId":"previewAgentTransfer","summary":"Show what an agent transfer would move","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Show what an agent transfer would move","content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewAgentTransferResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/transfer":{"post":{"operationId":"createAgentTransfer","summary":"Offer this agent to another account by email; nothing moves until they accept","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentTransferRequest"}}}},"responses":{"201":{"description":"Offer this agent to another account by email; nothing moves until they accept","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createAgentTransferResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/transfer/{transferId}/cancel":{"post":{"operationId":"cancelAgentTransfer","summary":"Cancel a pending outgoing agent transfer","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"transferId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Cancel a pending outgoing agent transfer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelAgentTransferResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/transfers":{"get":{"operationId":"listWorkspaceTransfers","summary":"List outgoing agent transfers from this workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List outgoing agent transfers from this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listWorkspaceTransfersResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/transfers":{"get":{"operationId":"listIncomingTransfers","summary":"List agent transfers offered to you","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[],"responses":{"200":{"description":"List agent transfers offered to you","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listIncomingTransfersResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/transfers/{transferId}":{"get":{"operationId":"readIncomingTransfer","summary":"Read one agent transfer offered to you","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"transferId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read one agent transfer offered to you","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readIncomingTransferResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/transfers/{transferId}/accept":{"post":{"operationId":"acceptAgentTransfer","summary":"Accept an agent transfer into one of your workspaces","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"transferId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/acceptAgentTransferRequest"}}}},"responses":{"200":{"description":"Accept an agent transfer into one of your workspaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/acceptAgentTransferResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/transfers/{transferId}/decline":{"post":{"operationId":"declineAgentTransfer","summary":"Decline an agent transfer offered to you","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:transfer"],"parameters":[{"name":"transferId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Decline an agent transfer offered to you","content":{"application/json":{"schema":{"$ref":"#/components/schemas/declineAgentTransferResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/voice/sessions":{"post":{"operationId":"startPlaygroundVoiceSession","summary":"Open a dashboard playground voice session; spends voice credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["agents:voice"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/startPlaygroundVoiceSessionRequest"}}}},"responses":{"201":{"description":"Open a dashboard playground voice session; spends voice credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startPlaygroundVoiceSessionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/widget-identity":{"get":{"operationId":"readWidgetIdentity","summary":"Read widget identity verification settings, including the signing secret for owners and admins","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["widget-identity:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read widget identity verification settings, including the signing secret for owners and admins","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readWidgetIdentityResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"put":{"operationId":"updateWidgetIdentity","summary":"Turn widget identity verification or history merging on or off","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["widget-identity:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWidgetIdentityRequest"}}}},"responses":{"200":{"description":"Turn widget identity verification or history merging on or off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updateWidgetIdentityResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/agents/{agentId}/support/widget-identity/rotate":{"post":{"operationId":"rotateWidgetIdentitySecret","summary":"Replace the widget identity signing secret; the old one stops working","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["widget-identity:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Replace the widget identity signing secret; the old one stops working","content":{"application/json":{"schema":{"$ref":"#/components/schemas/rotateWidgetIdentitySecretResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/api-keys":{"get":{"operationId":"listApiKeys","summary":"List workspace API keys by prefix; tokens are never returned","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["api-keys:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"List workspace API keys by prefix; tokens are never returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listApiKeysResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}},"post":{"operationId":"createApiKey","summary":"Create a workspace API key; the token is returned once","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["api-keys:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createApiKeyRequest"}}}},"responses":{"201":{"description":"Create a workspace API key; the token is returned once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createApiKeyResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/api-keys/{keyId}":{"delete":{"operationId":"revokeApiKey","summary":"Revoke a workspace API key","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["api-keys:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Revoke a workspace API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/revokeApiKeyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/api-keys/{keyId}/permanent":{"delete":{"operationId":"deleteApiKey","summary":"Permanently remove an already-revoked workspace API key","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["api-keys:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"keyId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Permanently remove an already-revoked workspace API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/deleteApiKeyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/checkout":{"post":{"operationId":"startPlanCheckout","summary":"Start a hosted checkout for a paid plan","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/startPlanCheckoutRequest"}}}},"responses":{"200":{"description":"Start a hosted checkout for a paid plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startPlanCheckoutResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/topups/checkout":{"post":{"operationId":"startTopUpCheckout","summary":"Start a hosted checkout for a credit top-up pack","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/startTopUpCheckoutRequest"}}}},"responses":{"200":{"description":"Start a hosted checkout for a credit top-up pack","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startTopUpCheckoutResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/change/preview":{"post":{"operationId":"previewPlanChange","summary":"Preview the charge for changing plan","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewPlanChangeRequest"}}}},"responses":{"200":{"description":"Preview the charge for changing plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewPlanChangeResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/change":{"post":{"operationId":"changePlan","summary":"Change the subscription plan; may charge the saved card","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/changePlanRequest"}}}},"responses":{"200":{"description":"Change the subscription plan; may charge the saved card","content":{"application/json":{"schema":{"$ref":"#/components/schemas/changePlanResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/cancel":{"post":{"operationId":"cancelSubscription","summary":"Cancel the subscription at the end of the period","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelSubscriptionRequest"}}}},"responses":{"200":{"description":"Cancel the subscription at the end of the period","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelSubscriptionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/resume":{"post":{"operationId":"resumeSubscription","summary":"Resume a subscription set to cancel","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/resumeSubscriptionRequest"}}}},"responses":{"200":{"description":"Resume a subscription set to cancel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/resumeSubscriptionResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/payment-method":{"post":{"operationId":"updatePaymentMethod","summary":"Start the hosted flow to replace the saved card","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/updatePaymentMethodRequest"}}}},"responses":{"200":{"description":"Start the hosted flow to replace the saved card","content":{"application/json":{"schema":{"$ref":"#/components/schemas/updatePaymentMethodResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/billing/auto-top-up":{"put":{"operationId":"setAutoTopUp","summary":"Set the automatic credit top-up policy","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["billing:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAutoTopUpRequest"}}}},"responses":{"200":{"description":"Set the automatic credit top-up policy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/setAutoTopUpResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/compliance/export":{"get":{"operationId":"exportWorkspaceData","summary":"Export every conversation, message and contact in the workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["compliance:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Export every conversation, message and contact in the workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/exportWorkspaceDataResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/compliance/conversations":{"delete":{"operationId":"eraseWorkspaceConversations","summary":"Permanently erase every conversation in the workspace","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["compliance:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Permanently erase every conversation in the workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/eraseWorkspaceConversationsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/support-requests/{requestId}/evidence/{evidenceId}/payload":{"delete":{"operationId":"eraseSupportEvidencePayload","summary":"Permanently erase one evidence payload from a support request","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["compliance:manage"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"requestId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"evidenceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/eraseSupportEvidencePayloadRequest"}}}},"responses":{"200":{"description":"Permanently erase one evidence payload from a support request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/eraseSupportEvidencePayloadResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{workspaceId}/analytics/insights/refresh":{"post":{"operationId":"refreshAgentInsights","summary":"Recompute topic and sentiment insights for one agent; spends credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/refreshAgentInsightsRequest"}}}},"responses":{"200":{"description":"Recompute topic and sentiment insights for one agent; spends credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/refreshAgentInsightsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{destinationWorkspaceId}/linked-analytics/insights/refresh":{"post":{"operationId":"refreshLinkedInsights","summary":"Recompute insights for a linked agent; spends credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Workspaces"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"destinationWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/refreshLinkedInsightsRequest"}}}},"responses":{"200":{"description":"Recompute insights for a linked agent; spends credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/refreshLinkedInsightsResponse"}}}},"400":{"description":"Invalid request, timezone, resource association or confirmation."},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/classification/jobs":{"post":{"operationId":"startClassificationJob","summary":"Classify past conversations for analytics; may spend credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Classify past conversations for analytics; may spend credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/startClassificationJobResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/classification/manual":{"post":{"operationId":"classifyConversationManually","summary":"Set the analytics classification of one conversation by hand","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Set the analytics classification of one conversation by hand","content":{"application/json":{"schema":{"$ref":"#/components/schemas/classifyConversationManuallyResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/{canonicalTopicId}/rename":{"post":{"operationId":"renameAnalyticsTopic","summary":"Rename an analytics topic","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"canonicalTopicId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Rename an analytics topic","content":{"application/json":{"schema":{"$ref":"#/components/schemas/renameAnalyticsTopicResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/{canonicalTopicId}/archive":{"post":{"operationId":"archiveAnalyticsTopic","summary":"Archive an analytics topic","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"canonicalTopicId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Archive an analytics topic","content":{"application/json":{"schema":{"$ref":"#/components/schemas/archiveAnalyticsTopicResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/merge":{"post":{"operationId":"mergeAnalyticsTopics","summary":"Merge analytics topics into one","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Merge analytics topics into one","content":{"application/json":{"schema":{"$ref":"#/components/schemas/mergeAnalyticsTopicsResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/reprocess/preview":{"post":{"operationId":"previewTopicReprocess","summary":"Preview the cost of regrouping conversations into topics","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Preview the cost of regrouping conversations into topics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/previewTopicReprocessResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/reprocess/confirm":{"post":{"operationId":"confirmTopicReprocess","summary":"Regroup conversations into topics; spends credits","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Regroup conversations into topics; spends credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/confirmTopicReprocessResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/reprocess/status":{"post":{"operationId":"readTopicReprocessStatus","summary":"Read the progress of a topic regroup","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Read the progress of a topic regroup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/readTopicReprocessStatusResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/workspaces/{requestingWorkspaceId}/agents/{agentId}/analytics/topics/reprocess/cancel":{"post":{"operationId":"cancelTopicReprocess","summary":"Cancel a running topic regroup","description":"Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.","tags":["Agents"],"security":[{"accountBearer":[]},{"accountSession":[]},{"localAccountSession":[]}],"x-required-account-scopes":["analytics:write"],"parameters":[{"name":"requestingWorkspaceId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"agentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Cancel a running topic regroup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cancelTopicReprocessResponse"}}}},"401":{"description":"Missing, invalid, expired or revoked account credential or application session."},"402":{"description":"Plan entitlement, capacity or credits do not allow this operation."},"403":{"description":"Required account scope, live verified identity, membership or role permission is missing."},"404":{"description":"Workspace or addressed resource is not visible to this member."},"409":{"description":"Support handle, source URL or pending transfer conflicts with this operation."},"422":{"description":"Website URL or extraction source is not supported."},"429":{"description":"Agent request or website crawl rate limit exceeded."},"500":{"description":"Unexpected server failure."},"503":{"description":"Authorization service temporarily unavailable."}}}},"/capabilities":{"get":{"operationId":"listCapabilities","summary":"List registered contracts and surface availability","description":"Reports registered shared contracts, schemas and adapter availability. Complete coverage means every account route is an operation or a documented exclusion; unavailable adapters are explicitly marked unsupported.","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Registered operation contracts and surface availability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityDocument"}}}}}}},"/oauth/token":{"post":{"operationId":"createAccessToken","summary":"Exchange API-key client credentials for an access token","description":"Uses HTTP Basic authentication where the API key ID is the client ID and the one-time `ck_` token is the client secret. Requested scopes must be a subset of the API key scope ceiling.","tags":["Authentication"],"security":[{"clientCredentialsBasic":[]}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["grant_type"],"properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"scope":{"type":"string","description":"Space-delimited subset of `agents:read` and `chat:write`."},"resource":{"type":"string","format":"uri","enum":["https://app.communicate.so/api/v1","https://app.communicate.so/mcp"],"default":"https://app.communicate.so/api/v1","description":"RFC 8707 resource audience. MCP tokens accept only `agents:read`."}}}}}},"responses":{"200":{"description":"Short-lived scoped bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthTokenResponse"}}}},"400":{"description":"Unsupported grant or invalid scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthErrorResponse"}}}},"401":{"description":"Invalid or revoked client credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthErrorResponse"}}}},"429":{"description":"Token request rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthErrorResponse"}}}}}}},"/agents":{"get":{"operationId":"listAgents","summary":"List agents in the API key workspace","description":"Returns the agents visible to the authenticated workspace API key. This route is non-streaming and shares the public API group rate limit of 600 requests per minute per key.","tags":["Agents"],"security":[{"oauth2":["agents:read"]},{"bearerAuth":[]}],"responses":{"200":{"description":"Workspace agents","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentSummary"}}}}},"401":{"description":"Missing or invalid API key","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge describing the API-key authentication failure."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Credential does not grant `agents:read`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"API key rate limit exceeded","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected server failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/agents/{agentId}/chat":{"post":{"operationId":"chatWithAgent","summary":"Send a chat turn to an agent","description":"Creates or continues an API-channel conversation and returns one complete response payload. This endpoint does not stream. `requestId` is optional idempotency; reusing it with different input yields `409 request_id_conflict`. Chat turns are additionally rate-limited to 60 requests per minute per key. Responses may include grounded citations and, when an action ran, `actionName`.","tags":["Chat"],"security":[{"oauth2":["chat:write"]},{"bearerAuth":[]}],"parameters":[{"name":"agentId","in":"path","required":true,"description":"The target agent identifier.","schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Completed non-streaming chat response","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}}}},"400":{"description":"Malformed JSON or invalid request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Bearer challenge describing the API-key authentication failure."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Chat generation is unavailable because billing is paused or credits are exhausted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Credential does not grant `chat:write`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Agent not found in the API key workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Agent is inactive, or requestId was replayed with different input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"API key rate limit exceeded","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Unexpected server failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Agent is mid-transfer and temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"headers":{"RateLimitLimit":{"description":"Maximum requests allowed in the active one-minute window.","schema":{"type":"integer","minimum":1}},"RateLimitRemaining":{"description":"Requests remaining in the active one-minute window.","schema":{"type":"integer","minimum":0}},"RateLimitReset":{"description":"Seconds until the active rate-limit window resets.","schema":{"type":"integer","minimum":1}}},"securitySchemes":{"accountSession":{"type":"apiKey","in":"cookie","name":"__Secure-better-auth.session_token","description":"Signed Better Auth session cookie for an HTTPS application origin. Credential management additionally requires verified email and fresh password proof on writes."},"localAccountSession":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"Signed session cookie used when the configured application auth origin is HTTP, such as local development."},"accountBearer":{"type":"http","scheme":"bearer","bearerFormat":"Account credential","description":"Opaque user-bound `ca_` account credential. Each request checks live account scopes, verified email, expiry, revocation and the issuer session. Not a workspace `ck_` key or OAuth access token."},"clientCredentialsBasic":{"type":"http","scheme":"basic","description":"Use the API key ID as the username and the one-time `ck_` API key token as the password."},"oauth2":{"type":"oauth2","description":"OAuth 2.0 client-credentials tokens bounded by the source API key scope ceiling.","flows":{"clientCredentials":{"tokenUrl":"https://app.communicate.so/api/v1/oauth/token","scopes":{"agents:read":"List agents in the authenticated workspace.","chat:write":"Create chat turns with an agent in the authenticated workspace."}}}},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Workspace API key token with the `ck_` prefix."}},"schemas":{"AccountCredentialReceipt":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":5,"maxLength":300},"prefix":{"type":"string"},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"token":{"readOnly":true,"description":"One-time credential secret; not present in subsequent metadata reads.","type":"string"}},"required":["id","name","prefix","scopes","expiresAt","token"],"additionalProperties":false},"AccountCredentialList":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":5,"maxLength":300},"prefix":{"type":"string"},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"audience":{"type":"string","enum":["https://app.communicate.so/api/v1","https://app.communicate.so/mcp"]},"revokedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"rotatedFromId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","name","prefix","scopes","expiresAt","audience","revokedAt","createdAt","rotatedFromId"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false},"AccountCredentialMetadata":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":5,"maxLength":300},"prefix":{"type":"string"},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"audience":{"type":"string","enum":["https://app.communicate.so/api/v1","https://app.communicate.so/mcp"]},"revokedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"rotatedFromId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","name","prefix","scopes","expiresAt","audience","revokedAt","createdAt","rotatedFromId"],"additionalProperties":false},"AccountCredentialRevocation":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revokedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","revokedAt"],"additionalProperties":false},"WorkspaceList":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"planId":{"type":"string"},"timezone":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lifetimePlanId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","planId","timezone","createdAt","updatedAt","lifetimePlanId"],"additionalProperties":false}},"Workspace":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"planId":{"type":"string"},"timezone":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","name","planId","timezone","createdAt","updatedAt"],"additionalProperties":false},"AccountPreferences":{"type":"object","properties":{"inboxView":{"type":"string","enum":["chat","ticket"]}},"required":["inboxView"],"additionalProperties":false},"createContactResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"company":{"anyOf":[{"type":"string"},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","email","name","location","company","companySize","createdAt","updatedAt"],"additionalProperties":false},"createContactRequest":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"location":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"company":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"additionalProperties":false},"listContactsResponse":{"type":"object","properties":{"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"company":{"anyOf":[{"type":"string"},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","email","name","location","company","companySize","createdAt","updatedAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"offset":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["contacts","total","limit","offset"],"additionalProperties":false},"removeContactResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true},"contactId":{"type":"string","minLength":1}},"required":["deleted","contactId"],"additionalProperties":false},"readContactProfileResponse":{"type":"object","properties":{"contact":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"company":{"anyOf":[{"type":"string"},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","email","name","location","company","companySize","createdAt","updatedAt"],"additionalProperties":false},"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["open","closed"]},"channel":{"type":"string","enum":["playground","widget","api","email","dashboard"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","subject","status","channel","createdAt"],"additionalProperties":false}}},"required":["contact","conversations"],"additionalProperties":false},"updateContactProfileResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"company":{"anyOf":[{"type":"string"},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","email","name","location","company","companySize","createdAt","updatedAt"],"additionalProperties":false},"updateContactProfileRequest":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"location":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"company":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"additionalProperties":false},"listInboxLiveSupportRequestsResponse":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"openedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"requestIntakeChannel":{"type":"string","enum":["widget","email","api","playground","dashboard","voice","unknown"]},"handlingState":{"type":"string","enum":["active","waiting_agent","waiting_member","waiting_customer","waiting_external"]}},"required":["id","lifecycleVersion","openedAt","requestIntakeChannel","handlingState"],"additionalProperties":false}}},"required":["requests"],"additionalProperties":false},"requestInboxCopilotSuggestionResponse":{"type":"object","properties":{"text":{"type":"string"}},"required":["text"],"additionalProperties":false},"requestInboxCopilotSuggestionRequest":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","summarise","answer","translate"]},"question":{"type":"string","minLength":1,"maxLength":2000},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"text":{"type":"string","minLength":1,"maxLength":4000},"targetLanguage":{"type":"string","enum":["English","Spanish","French","German","Portuguese","Italian","Dutch","Russian","Chinese","Japanese","Korean","Hindi","Arabic"]}},"required":["mode","requestId"],"additionalProperties":false},"endorseInboxCopilotLearningResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false},"endorseInboxCopilotLearningRequest":{"type":"object","properties":{"learningId":{"type":"string","minLength":1}},"required":["learningId"],"additionalProperties":false},"presignInboxAttachmentResponse":{"type":"object","properties":{"attachmentId":{"type":"string","minLength":1},"putUrl":{"type":"string","format":"uri"},"key":{"type":"string","minLength":1},"headers":{"type":"object","properties":{"Content-Type":{"type":"string"}},"required":["Content-Type"],"additionalProperties":false}},"required":["attachmentId","putUrl","key","headers"],"additionalProperties":false},"presignInboxAttachmentRequest":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","minLength":1},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["filename","contentType"],"additionalProperties":false},"confirmInboxAttachmentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"filename":{"type":"string"},"contentType":{"type":"string"},"detectedContentType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sizeBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"kind":{"type":"string"},"attachmentState":{"type":"string"},"messageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["id","filename","contentType","detectedContentType","sizeBytes","kind","attachmentState","messageId"],"additionalProperties":false},"confirmInboxAttachmentRequest":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","minLength":1},"attachmentId":{"type":"string","minLength":1},"key":{"type":"string","minLength":1},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["filename","contentType","attachmentId","key","sizeBytes"],"additionalProperties":false},"readInboxAttachmentUrlResponse":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"disposition":{"type":"string","enum":["inline","attachment"]},"filename":{"type":"string"},"contentType":{"type":"string"}},"required":["url","disposition","filename","contentType"],"additionalProperties":false},"retryInboxReplyResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"role":{"type":"string","const":"human"},"content":{"type":"string"},"replyToMessageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channel":{"anyOf":[{"type":"string","enum":["widget","email"]},{"type":"null"}]},"lifecycleStatus":{"type":"string","enum":["queued","sending","sent","undone","failed","uncertain","bounced"]},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dispatchAfterAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"undoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sentAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","conversationId","agentId","role","content","channel","lifecycleStatus","lifecycleVersion","revisionCount","authorMemberId","createdAt","dispatchAfterAt","undoDeadlineAt","sentAt"],"additionalProperties":false},"retryInboxReplyRequest":{"type":"object","properties":{"confirmDuplicateRisk":{"type":"boolean"}},"additionalProperties":false},"mergeSupportRequestsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"mergeSupportRequestsRequest":{"type":"object","properties":{"sourceSupportRequests":{"minItems":2,"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","expectedVersion"],"additionalProperties":false}},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","minLength":1,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["sourceSupportRequests","idempotencyKey","reason"],"additionalProperties":false},"splitSupportRequestResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"splitSupportRequestRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"partitions":{"minItems":2,"maxItems":100,"type":"array","items":{"type":"object","properties":{"messageIds":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["messageIds"],"additionalProperties":false}},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","minLength":1,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["expectedVersion","partitions","idempotencyKey","reason"],"additionalProperties":false},"transitionSupportRequestResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"transitionSupportRequestRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"transition":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"activate"}},"required":["kind"]},{"type":"object","properties":{"kind":{"type":"string","const":"wait"},"waitingOn":{"type":"string","enum":["agent","member","customer","external"]}},"required":["kind","waitingOn"]},{"type":"object","properties":{"kind":{"type":"string","const":"end"},"outcome":{"type":"string","enum":["ended_unverified","failed","withdrawn","excluded"]}},"required":["kind","outcome"]},{"type":"object","properties":{"kind":{"type":"string","const":"reopen"}},"required":["kind"]}]},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","minLength":1,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["expectedVersion","transition","idempotencyKey","reason"]},"appendSupportRequestEvidenceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"appendSupportRequestEvidenceRequest":{"type":"object","properties":{"boundaryVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expectedLifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"evidence":{"type":"object","properties":{"type":{"type":"string","enum":["external_attestation","action_postcondition"]},"receiptId":{"type":"string","minLength":1,"maxLength":200},"sourceVersion":{"type":"string","minLength":1,"maxLength":200},"sourceHash":{"type":"string","minLength":1,"maxLength":500}},"required":["type","receiptId","sourceVersion","sourceHash"]}},"required":["boundaryVersion","expectedLifecycleVersion","idempotencyKey","evidence"]},"bindSupportRequestSlaResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bindSupportRequestSlaRequest":{"type":"object","properties":{"priority":{"type":"string","minLength":1,"maxLength":100},"teamId":{"type":"string","minLength":1},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["priority"]},"recordSupportRequestSlaMilestoneResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"recordSupportRequestSlaMilestoneRequest":{"type":"object","properties":{"episodeNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"kind":{"type":"string","enum":["first_response","next_response","handoff_pickup","approval_review","verified_resolution"]},"messageId":{"type":"string","minLength":1},"transportStatus":{"type":"string","enum":["accepted","failed","uncertain","cancelled"]},"responseKind":{"type":"string","enum":["substantive","clarification","policy_refusal","acknowledgement","routing","handoff","internal_note"]},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["episodeNumber","kind","messageId","transportStatus","responseKind","observedAt"]},"readSupportRequestSlaClockResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listWorkspaceLabelsResponse":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"color":{"type":"string","minLength":1,"maxLength":30,"pattern":"^#[0-9a-fA-F]{6}$|^[a-z][a-z0-9-]*$"},"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1}},"required":["name","color","id","workspaceId"],"additionalProperties":false}},"createWorkspaceLabelResponse":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"color":{"type":"string","minLength":1,"maxLength":30,"pattern":"^#[0-9a-fA-F]{6}$|^[a-z][a-z0-9-]*$"},"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1}},"required":["name","color","id","workspaceId"],"additionalProperties":false},"createWorkspaceLabelRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"color":{"type":"string","minLength":1,"maxLength":30,"pattern":"^#[0-9a-fA-F]{6}$|^[a-z][a-z0-9-]*$"}},"required":["name","color"],"additionalProperties":false},"updateWorkspaceLabelResponse":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"color":{"type":"string","minLength":1,"maxLength":30,"pattern":"^#[0-9a-fA-F]{6}$|^[a-z][a-z0-9-]*$"},"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1}},"required":["name","color","id","workspaceId"],"additionalProperties":false},"updateWorkspaceLabelRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":40},"color":{"type":"string","minLength":1,"maxLength":30,"pattern":"^#[0-9a-fA-F]{6}$|^[a-z][a-z0-9-]*$"}},"additionalProperties":false},"deleteWorkspaceLabelResponse":{"type":"null"},"attachInboxLabelResponse":{"type":"null"},"detachInboxLabelResponse":{"type":"null"},"createInboxNoteResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"authorId":{"type":"string","minLength":1},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorAgentGrantId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorKind":{"type":"string","enum":["source_member","linked_member","system"]},"audienceKind":{"type":"string","enum":["source_only","source_plus_author_destination"]},"audienceDestinationWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","conversationId","authorId","authorMemberId","authorWorkspaceId","authorAgentGrantId","authorKind","audienceKind","audienceDestinationWorkspaceId","body","createdAt"],"additionalProperties":false},"createInboxNoteRequest":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":4000}},"required":["body"],"additionalProperties":false},"markInboxConversationReadResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false},"readInboxConversationResponse":{"type":"object","properties":{"serverNow":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"conversation":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"channel":{"type":"string","enum":["playground","widget","api","email","dashboard"]},"surface":{"type":"string","enum":["widget","hosted"]},"visitorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"contactId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"status":{"type":"string","enum":["open","closed"]},"mode":{"type":"string","enum":["ai","human"]},"modeLocked":{"type":"boolean"},"modeSource":{"type":"string","enum":["legacy","manual","message_lifecycle"]},"modeVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"contactEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"visitorLastSeenAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"visitorSeenAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"agentSeenAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"visitorUserAgent":{"anyOf":[{"type":"string"},{"type":"null"}]},"visitorTimezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketNumber":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visitorIp":{"anyOf":[{"type":"string"},{"type":"null"}]},"visitorCountry":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastMessageAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"messageCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"agentName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","workspaceId","agentId","channel","surface","visitorId","subject","createdBy","contactId","status","mode","modeLocked","modeSource","modeVersion","contactEmail","visitorLastSeenAt","visitorSeenAt","agentSeenAt","visitorUserAgent","visitorTimezone","ticketNumber","visitorIp","visitorCountry","createdAt","lastMessageAt","messageCount","agentName"],"additionalProperties":false},"inbox":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","closed","snoozed","spam"]},"assigneeId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"teamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"priority":{"type":"string","enum":["low","normal","high","urgent"]},"dueAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"assigneeMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"assigneeWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"assigneeAgentGrantId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"assigneeKind":{"anyOf":[{"type":"string","enum":["source_member","linked_member"]},{"type":"null"}]},"assigneeAssignedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"assigneeAssignedByMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"assigneeAssignedByWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"assigneeAssignedByAgentGrantId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"escalatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"escalationStatus":{"anyOf":[{"type":"string","enum":["pending","claimed"]},{"type":"null"}]}},"required":["conversationId","status","assigneeId","teamId","priority","dueAt","updatedAt"],"additionalProperties":false},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"role":{"type":"string","enum":["user","assistant","human"]},"content":{"type":"string"},"replyToMessageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"citations":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string","minLength":1},"title":{"type":"string"},"snippet":{"type":"string"}},"required":["sourceId","title","snippet"],"additionalProperties":false}},{"type":"null"}]},"channel":{"anyOf":[{"type":"string","enum":["widget","email"]},{"type":"null"}]},"emailOpenedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"emailRaw":{"anyOf":[{"type":"object","properties":{"text":{"type":"string"},"html":{"type":"string"},"quotedHistory":{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false}},"additionalProperties":false},{"type":"null"}]},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"lifecycleStatus":{"type":"string","enum":["queued","sending","sent","undone","failed","uncertain","bounced"]},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"undoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sentAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"editDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"editedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"latestFailureCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"messageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"uploadedByMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"uploadedByVisitorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploadedByWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"uploadedByAgentGrantId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"uploadedByKind":{"type":"string","enum":["visitor","source_member","linked_member","system"]},"filename":{"type":"string"},"contentType":{"type":"string"},"detectedContentType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sizeBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"kind":{"type":"string","enum":["image","file"]},"inline":{"type":"boolean"},"contentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"attachmentState":{"type":"string","enum":["staged","uploaded","processing","clean","linked","blocked","failed"]},"blockedReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploadConfirmedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"scanCompletedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"quarantinedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"linkedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","conversationId","messageId","uploadedByMemberId","uploadedByVisitorId","uploadedByWorkspaceId","uploadedByAgentGrantId","uploadedByKind","filename","contentType","detectedContentType","sizeBytes","kind","inline","contentId","attachmentState","blockedReason","uploadConfirmedAt","scanCompletedAt","quarantinedAt","linkedAt","createdAt"],"additionalProperties":false}}},"required":["id","role","content","citations","channel","emailOpenedAt","emailRaw","authorMemberId","lifecycleStatus","lifecycleVersion","revisionCount","undoDeadlineAt","sentAt","editDeadlineAt","editedAt","latestFailureCode","createdAt","attachments"],"additionalProperties":false}},"notes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"authorId":{"type":"string","minLength":1},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorAgentGrantId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"authorKind":{"type":"string","enum":["source_member","linked_member","system"]},"audienceKind":{"type":"string","enum":["source_only","source_plus_author_destination"]},"audienceDestinationWorkspaceId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"body":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","conversationId","authorId","authorMemberId","authorWorkspaceId","authorAgentGrantId","authorKind","audienceKind","audienceDestinationWorkspaceId","body","createdAt"],"additionalProperties":false}},"contact":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"company":{"anyOf":[{"type":"string"},{"type":"null"}]},"companySize":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","email","name","location","company","companySize","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"voiceSessions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"status":{"type":"string","enum":["starting","active","finalizing","completed","failed","abandoned"]},"recordingStatus":{"type":"string","enum":["pending","available","failed","deleted"]},"durationSeconds":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"playbackUrl":{"type":"string"},"transcript":{"type":"array","items":{"type":"object","properties":{"messageId":{"type":"string","minLength":1},"role":{"type":"string","enum":["user","assistant"]},"text":{"type":"string"},"startMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"endMs":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["messageId","role","text"],"additionalProperties":false}}},"required":["id","status","recordingStatus","durationSeconds","summary","transcript"],"additionalProperties":false}},"recentConversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["open","closed"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastMessageAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","subject","status","createdAt","lastMessageAt"],"additionalProperties":false}},"labels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"csatRating":{"anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]}},"required":["serverNow","conversation","inbox","messages","notes","contact","voiceSessions","recentConversations","labels","csatRating"],"additionalProperties":false},"updateInboxConversationResponse":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","snoozed","closed","spam"]},"assigneeId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"teamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"priority":{"type":"string","enum":["low","normal","high","urgent"]},"dueAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"mode":{"type":"string","enum":["ai","human"]}},"required":["conversationId","workspaceId","status","assigneeId","teamId","priority","dueAt","updatedAt"],"additionalProperties":false},"updateInboxConversationRequest":{"type":"object","properties":{"status":{"type":"string","enum":["open","snoozed","closed","spam"]},"assigneeId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"priority":{"type":"string","enum":["low","normal","high","urgent"]},"dueAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"mode":{"type":"string","enum":["ai","human"]},"teamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"contactEmail":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"notify":{"type":"boolean"},"force":{"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"dispositions":{"type":"array","items":{"type":"object","properties":{"supportRequestId":{"type":"string","minLength":1},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"outcome":{"type":"string","enum":["ended_unverified","failed","withdrawn","excluded"]},"reason":{"type":"string","minLength":1,"maxLength":1000}},"required":["supportRequestId","expectedVersion","outcome","reason"],"additionalProperties":false}}},"additionalProperties":false},"editInboxReplyResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"role":{"type":"string","const":"human"},"content":{"type":"string"},"replyToMessageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channel":{"anyOf":[{"type":"string","enum":["widget","email"]},{"type":"null"}]},"lifecycleStatus":{"type":"string","enum":["queued","sending","sent","undone","failed","uncertain","bounced"]},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dispatchAfterAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"undoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sentAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","conversationId","agentId","role","content","channel","lifecycleStatus","lifecycleVersion","revisionCount","authorMemberId","createdAt","dispatchAfterAt","undoDeadlineAt","sentAt"],"additionalProperties":false},"editInboxReplyRequest":{"type":"object","properties":{"content":{"type":"string","maxLength":4000},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["content","expectedVersion"],"additionalProperties":false},"undoInboxReplyResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"role":{"type":"string","const":"human"},"content":{"type":"string"},"replyToMessageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channel":{"anyOf":[{"type":"string","enum":["widget","email"]},{"type":"null"}]},"lifecycleStatus":{"type":"string","enum":["queued","sending","sent","undone","failed","uncertain","bounced"]},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dispatchAfterAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"undoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sentAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","conversationId","agentId","role","content","channel","lifecycleStatus","lifecycleVersion","revisionCount","authorMemberId","createdAt","dispatchAfterAt","undoDeadlineAt","sentAt"],"additionalProperties":false},"sendInboxReplyResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"conversationId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"role":{"type":"string","const":"human"},"content":{"type":"string"},"replyToMessageId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channel":{"anyOf":[{"type":"string","enum":["widget","email"]},{"type":"null"}]},"lifecycleStatus":{"type":"string","enum":["queued","sending","sent","undone","failed","uncertain","bounced"]},"lifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"revisionCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"authorMemberId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"dispatchAfterAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"undoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"sentAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","conversationId","agentId","role","content","channel","lifecycleStatus","lifecycleVersion","revisionCount","authorMemberId","createdAt","dispatchAfterAt","undoDeadlineAt","sentAt"],"additionalProperties":false},"sendInboxReplyRequest":{"type":"object","properties":{"content":{"type":"string","maxLength":4000},"messageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attachmentIds":{"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"replyToMessageId":{"type":"string","minLength":1,"maxLength":200}},"required":["content","messageId"],"additionalProperties":false},"listInboxConversationsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"agentName":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"type":"string","enum":["playground","widget","api","email","dashboard"]},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketNumber":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"mode":{"type":"string","enum":["ai","human"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastMessageAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"contactId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"messageCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"preview":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastMessageRole":{"anyOf":[{"type":"string"},{"type":"null"}]},"inboxStatus":{"type":"string","enum":["open","snoozed","closed","spam"]},"assigneeId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"teamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"priority":{"type":"string"},"dueAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"unseenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"awaitingTeammate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}}},"required":["id","agentId","agentName","channel","subject","ticketNumber","mode","createdAt","lastMessageAt","contactId","createdBy","messageCount","preview","lastMessageRole","inboxStatus","assigneeId","teamId","priority","dueAt","unseenCount","awaitingTeammate","labels"],"additionalProperties":false}},"readInboxCountsResponse":{"type":"object","properties":{"open":{"type":"integer","minimum":0,"maximum":9007199254740991},"unassigned":{"type":"integer","minimum":0,"maximum":9007199254740991},"mine":{"type":"integer","minimum":0,"maximum":9007199254740991},"snoozed":{"type":"integer","minimum":0,"maximum":9007199254740991},"closed":{"type":"integer","minimum":0,"maximum":9007199254740991},"unread":{"type":"integer","minimum":0,"maximum":9007199254740991},"spam":{"type":"integer","minimum":0,"maximum":9007199254740991},"unseen":{"type":"integer","minimum":0,"maximum":9007199254740991},"mentions":{"type":"integer","minimum":0,"maximum":9007199254740991},"byTeam":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"byAgent":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"outbox":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"entries":{"type":"array","items":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"type":"string","enum":["playground","widget","api","email","dashboard"]},"pendingCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"lifecycleStatus":{"type":"string","enum":["queued","sending"]},"nextUndoDeadlineAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["conversationId","subject","channel","pendingCount","lifecycleStatus","nextUndoDeadlineAt"],"additionalProperties":false}}},"required":["total","entries"],"additionalProperties":false}},"required":["open","unassigned","mine","snoozed","closed","unread","spam","unseen","mentions","byTeam","byAgent"],"additionalProperties":false},"listLinkedConversationsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"countLinkedConversationsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readLinkedConversationResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"markLinkedConversationReadResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"requestLinkedCopilotSuggestionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"requestLinkedCopilotSuggestionRequest":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","summarise","answer"]},"question":{"type":"string","minLength":1,"maxLength":2000},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["mode","requestId"],"additionalProperties":false},"endorseLinkedCopilotLearningResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"endorseLinkedCopilotLearningRequest":{"type":"object","properties":{"learningId":{"type":"string","minLength":1}},"required":["learningId"],"additionalProperties":false},"presignLinkedAttachmentResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"presignLinkedAttachmentRequest":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","minLength":1},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["filename","contentType"],"additionalProperties":false},"confirmLinkedAttachmentResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmLinkedAttachmentRequest":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","minLength":1},"attachmentId":{"type":"string","minLength":1},"key":{"type":"string","minLength":1},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["filename","contentType","attachmentId","key","sizeBytes"],"additionalProperties":false},"readLinkedAttachmentUrlResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"sendLinkedConversationReplyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"sendLinkedConversationReplyRequest":{"type":"object","properties":{"content":{"type":"string","maxLength":4000},"messageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"attachmentIds":{"maxItems":5,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["content"],"additionalProperties":false},"undoLinkedConversationReplyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"editLinkedConversationReplyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"editLinkedConversationReplyRequest":{"type":"object","properties":{"content":{"type":"string","maxLength":4000},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["content","expectedVersion"],"additionalProperties":false},"retryLinkedConversationReplyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"retryLinkedConversationReplyRequest":{"type":"object","properties":{"confirmDuplicateRisk":{"type":"boolean"}},"additionalProperties":false},"addLinkedConversationNoteResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"addLinkedConversationNoteRequest":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":10000}},"required":["body"],"additionalProperties":false},"addLinkedConversationLabelResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"removeLinkedConversationLabelResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"assignLinkedConversationResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"assignLinkedConversationRequest":{"type":"object","properties":{"memberId":{"type":"string","minLength":1}},"additionalProperties":false},"takeOverLinkedConversationResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setLinkedConversationStatusResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setLinkedConversationStatusRequest":{"type":"object","properties":{"status":{"type":"string","enum":["open","closed","snoozed","spam"]},"force":{"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"dispositions":{"type":"array","items":{"type":"object","properties":{"supportRequestId":{"type":"string","minLength":1},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"outcome":{"type":"string","enum":["ended_unverified","failed","withdrawn","excluded"]},"reason":{"type":"string","minLength":1,"maxLength":1000}},"required":["supportRequestId","expectedVersion","outcome","reason"]}}},"required":["status"],"additionalProperties":false},"runLinkedConversationActionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"runLinkedConversationActionRequest":{"type":"object","properties":{"args":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["args"],"additionalProperties":false},"listConversationsResponse":{},"readConversationResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setConversationStatusResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setConversationStatusRequest":{"type":"object","properties":{"status":{"type":"string","enum":["open","closed"]},"force":{"type":"boolean"},"idempotencyKey":{"type":"string"},"dispositions":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["status"]},"startConversationResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startConversationRequest":{"type":"object","properties":{"agentId":{"type":"string","minLength":1},"message":{"type":"string","minLength":1,"maxLength":4000},"subject":{"type":"string","maxLength":200},"contactId":{"type":"string","minLength":1},"contactEmail":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["agentId","message"]},"readWorkspaceResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"planId":{"type":"string"},"timezone":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","name","planId","timezone","createdAt","updatedAt"],"additionalProperties":false},"updateWorkspaceResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"planId":{"type":"string"},"timezone":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","name","planId","timezone","createdAt","updatedAt"],"additionalProperties":false},"updateWorkspaceRequest":{"anyOf":[{"required":["name"]},{"required":["timezone"]}],"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"timezone":{"description":"A timezone accepted by the platform Intl implementation, such as UTC or Asia/Kolkata.","type":"string","minLength":1,"maxLength":100}}},"deleteWorkspaceResponse":{"type":"null"},"deleteWorkspaceRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255}},"required":["name"]},"listWorkspaceMembersResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["owner","admin","agent_builder","support_lead","member","analyst","viewer"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","userId","role","createdAt","name","email"],"additionalProperties":false}},"addWorkspaceMemberResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["owner","admin","agent_builder","support_lead","member","analyst","viewer"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","userId","role","createdAt"],"additionalProperties":false},"addWorkspaceMemberRequest":{"type":"object","properties":{"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]}},"required":["userId","role"]},"updateWorkspaceMemberRoleResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["owner","admin","agent_builder","support_lead","member","analyst","viewer"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","userId","role","createdAt"],"additionalProperties":false},"updateWorkspaceMemberRoleRequest":{"type":"object","properties":{"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]}},"required":["role"]},"removeWorkspaceMemberResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"listWorkspaceInvitesResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]},"token":{"type":"string"},"inviteUrl":{"type":"string"},"status":{"type":"string","enum":["pending","accepted","revoked"]},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"acceptedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","email","role","token","inviteUrl","status","expiresAt","createdAt","acceptedAt"],"additionalProperties":false}},"createWorkspaceInviteResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]},"token":{"type":"string"},"inviteUrl":{"type":"string"},"status":{"type":"string","enum":["pending","accepted","revoked"]},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"acceptedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","email","role","token","inviteUrl","status","expiresAt","createdAt","acceptedAt"],"additionalProperties":false},"createWorkspaceInviteRequest":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]}},"required":["email","role"]},"resendWorkspaceInviteResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"email":{"type":"string"},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]},"token":{"type":"string"},"inviteUrl":{"type":"string"},"status":{"type":"string","enum":["pending","accepted","revoked"]},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"acceptedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","email","role","token","inviteUrl","status","expiresAt","createdAt","acceptedAt"],"additionalProperties":false},"cancelWorkspaceInviteResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"acceptWorkspaceInviteResponse":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1},"role":{"type":"string","enum":["admin","agent_builder","support_lead","member","analyst","viewer"]},"status":{"type":"string","const":"accepted"}},"required":["workspaceId","role","status"],"additionalProperties":false},"readMemberAgentAccessResponse":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string","minLength":1}}},"required":["agentIds"],"additionalProperties":false},"updateMemberAgentAccessResponse":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string","minLength":1}}},"required":["agentIds"],"additionalProperties":false},"updateMemberAgentAccessRequest":{"type":"object","properties":{"agentIds":{"type":"array","items":{"type":"string","minLength":1}}},"required":["agentIds"]},"listTeamsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"members":{"type":"array","items":{"type":"object","properties":{"memberId":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1},"role":{"type":"string","enum":["owner","admin","agent_builder","support_lead","member","analyst","viewer"]}},"required":["memberId","userId","role"],"additionalProperties":false}}},"required":["id","name","createdAt","members"],"additionalProperties":false}},"createTeamResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"members":{"type":"array","items":{"not":{}}}},"required":["id","workspaceId","name","createdAt","members"],"additionalProperties":false},"createTeamRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"]},"updateTeamResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","createdAt"],"additionalProperties":false},"updateTeamRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"]},"deleteTeamResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"addTeamMemberResponse":{"type":"object","properties":{"teamId":{"type":"string","minLength":1},"memberId":{"type":"string","minLength":1}},"required":["teamId","memberId"],"additionalProperties":false},"addTeamMemberRequest":{"type":"object","properties":{"memberId":{"type":"string","minLength":1}},"required":["memberId"]},"removeTeamMemberResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"listCustomDomainsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"domain":{"type":"string"},"status":{"type":"string"}},"required":["id","agentId","domain","status"],"additionalProperties":{}}},"createCustomDomainResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"domain":{"type":"string"},"status":{"type":"string"}},"required":["id","agentId","domain","status"],"additionalProperties":{}},"createCustomDomainRequest":{"type":"object","properties":{"agentId":{"type":"string","minLength":1},"domain":{"type":"string","maxLength":253}},"required":["agentId","domain"]},"verifyCustomDomainResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"domain":{"type":"string"},"status":{"type":"string"}},"required":["id","agentId","domain","status"],"additionalProperties":{}},"removeCustomDomainResponse":{"anyOf":[{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},{"type":"object","properties":{"parked":{"type":"boolean","const":true}},"required":["parked"],"additionalProperties":false}]},"listWebhooksResponse":{"type":"object","properties":{"events":{"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}},"webhooks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}},"enabled":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","url","events","enabled","createdAt"],"additionalProperties":false}}},"required":["events","webhooks"],"additionalProperties":false},"createWebhookResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}},"enabled":{"type":"boolean"},"signingSecret":{"type":"string"}},"required":["id","url","events","enabled","signingSecret"],"additionalProperties":false},"createWebhookRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}}},"required":["url"]},"updateWebhookResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"url":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}},"enabled":{"type":"boolean"}},"required":["id","url","events","enabled"],"additionalProperties":false},"updateWebhookRequest":{"type":"object","properties":{"enabled":{"type":"boolean"},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["conversation.created","message.sent","message.edited","message.failed"]}}}},"deleteWebhookResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"readWorkspaceAnalyticsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentInsightsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readBillingResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readBillingPurchasesResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readBillingUsageResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readLinkedAnalyticsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readLinkedInsightsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsSummaryResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsSurfaceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsReportResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentClassificationPolicyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentClassificationJobResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsExportResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readAgentAnalyticsDrilldownResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readSourceSuggestionsResponse":{"type":"object","properties":{"summary":{"type":"object","properties":{"sourceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"readySourceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sampledMessages":{"type":"integer","minimum":0,"maximum":50}},"required":["sourceCount","readySourceCount","sampledMessages"],"additionalProperties":false},"suggestions":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"kind":{"type":"string","enum":["missing_content","source_health","duplicate_source"]},"priority":{"type":"string","enum":["high","medium","low"]},"title":{"type":"string"},"detail":{"type":"string"},"evidence":{"type":"string"},"action":{"type":"string"}},"required":["id","kind","priority","title","detail","evidence","action"],"additionalProperties":false}}},"required":["summary","suggestions"],"additionalProperties":false},"listAgentModelsResponse":{"type":"object","properties":{"defaultModelId":{"type":"string"},"planId":{"type":"string"},"isFreePlan":{"type":"boolean"},"models":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"provider":{"type":"string"},"usageMultiplier":{"type":"number"},"usageLabel":{"type":"string"},"freeAllowed":{"type":"boolean"},"eligible":{"type":"boolean"}},"required":["id","name","provider","usageMultiplier","usageLabel","freeAllowed","eligible"],"additionalProperties":false}}},"required":["defaultModelId","planId","isFreePlan","models"],"additionalProperties":false},"listWorkspaceAgentsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"messageCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"conversationCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolvedRate":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt","messageCount","conversationCount","sourceCount","resolvedRate"],"additionalProperties":false}},"createAgentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt"],"additionalProperties":false},"createAgentRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":100},"systemPrompt":{"type":"string"},"status":{"type":"string","enum":["active","inactive","draft"]},"model":{"type":"string","minLength":1,"maxLength":100},"temperature":{"type":"number","minimum":0,"maximum":1},"rateLimitPerMinute":{"type":"integer","minimum":1,"maximum":600},"allowedDomains":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":253}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"]}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}}},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"]}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"]}},"required":["id","label","type","required"]}}},"required":["enabled","fields"]},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}}},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}}},"escalationTeamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},{"type":"null"}]},"logoUrl":{"anyOf":[{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},{"type":"null"}]},"supportEmail":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+$"},"emailFromName":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"indexable":{"type":"boolean"}},"required":["name"]},"listHelpArticlesResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createHelpArticleResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createHelpArticleRequest":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"collection":{"type":"string","maxLength":80},"body":{"type":"string","minLength":1,"maxLength":50000},"published":{"type":"boolean"},"aiTrained":{"type":"boolean"}},"required":["title","body"],"additionalProperties":false},"updateHelpArticleResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateHelpArticleRequest":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"collection":{"type":"string","maxLength":80},"body":{"type":"string","minLength":1,"maxLength":50000},"published":{"type":"boolean"},"aiTrained":{"type":"boolean"}},"additionalProperties":false},"listAgentGrantsResponse":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"readAgentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt"],"additionalProperties":false},"updateAgentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt"],"additionalProperties":false},"updateAgentRequest":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":100},"systemPrompt":{"type":"string"},"status":{"type":"string","enum":["active","inactive","draft"]},"model":{"type":"string","minLength":1,"maxLength":100},"temperature":{"type":"number","minimum":0,"maximum":1},"rateLimitPerMinute":{"type":"integer","minimum":1,"maximum":600},"allowedDomains":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":253}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"]}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}}},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"]}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"]}},"required":["id","label","type","required"]}}},"required":["enabled","fields"]},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"]}}},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}}},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}}},"escalationTeamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},{"type":"null"}]},"logoUrl":{"anyOf":[{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},{"type":"null"}]},"supportEmail":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+$"},"emailFromName":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"indexable":{"type":"boolean"},"chatPageEnabled":{"type":"boolean"}}},"readAgentSetupResponse":{"type":"object","properties":{"steps":{"type":"object","properties":{"addSource":{"type":"boolean"},"publish":{"type":"boolean"},"addAction":{"type":"boolean"},"customizeWidget":{"type":"boolean"}},"required":["addSource","publish","addAction","customizeWidget"],"additionalProperties":false},"done":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"number","const":4}},"required":["steps","done","total"],"additionalProperties":false},"fetchAgentLogoResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt"],"additionalProperties":false},"fetchAgentLogoRequest":{"type":"object","properties":{"website":{"type":"string","format":"uri"}},"additionalProperties":false},"readVoiceCatalogResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listAgentContactsResponse":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"chatWithAgentPreviewResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chatWithAgentPreviewRequest":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"conversationId":{"anyOf":[{"type":"string"},{"type":"null"}]},"enabledActionIds":{"maxItems":100,"type":"array","items":{"type":"string"}},"timeZone":{"type":"string","minLength":1,"maxLength":100}},"required":["message"]},"duplicateAgentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"name":{"type":"string"},"systemPrompt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["active","inactive","draft"]},"inTransfer":{"type":"boolean"},"model":{"type":"string"},"temperature":{"type":"number"},"rateLimitPerMinute":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedDomains":{"type":"array","items":{"type":"string"}},"widgetConfig":{"type":"object","properties":{"accentColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"displayName":{"type":"string","maxLength":60},"greeting":{"type":"string","maxLength":500},"suggestedPrompts":{"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"promptGroups":{"maxItems":4,"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":80},"prompts":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}}},"required":["title","prompts"],"additionalProperties":false}},"labels":{"type":"object","properties":{"locale":{"type":"string","enum":["en","es","fr","de","pt"]},"composerPlaceholder":{"type":"string","maxLength":120},"sendButton":{"type":"string","maxLength":40},"openButton":{"type":"string","maxLength":80},"poweredBy":{"type":"string","maxLength":80}},"additionalProperties":false},"messagePlaceholder":{"type":"string","maxLength":120},"privacyPolicyUrl":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500},"dictationEnabled":{"type":"boolean"},"showPoweredBy":{"type":"boolean"},"bubblePosition":{"type":"string","enum":["right","left"]},"socialLinks":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":40},"url":{"format":"uri","description":"A URL with HTTP or HTTPS protocol.","type":"string","maxLength":500}},"required":["label","url"],"additionalProperties":false}},"showSupportEmail":{"type":"boolean"},"chatPageTheme":{"type":"string","enum":["light","dark","both"]},"widgetEnabled":{"type":"boolean"},"preChatForm":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,40}$"},"label":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["email","text","select"]},"required":{"type":"boolean"},"options":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"showWhen":{"type":"object","properties":{"fieldId":{"type":"string","minLength":1,"maxLength":40},"equals":{"type":"string","minLength":1,"maxLength":80}},"required":["fieldId","equals"],"additionalProperties":false}},"required":["id","label","type","required"],"additionalProperties":false}}},"required":["enabled","fields"],"additionalProperties":false},"offlineForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false},"notifyConfig":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"onNewConversation":{"type":"boolean"}},"additionalProperties":false},"voiceConfig":{"allOf":[{"if":{"properties":{"enabled":{"const":true}},"required":["enabled"]},"then":{"required":["voiceId"]}}],"type":"object","properties":{"enabled":{"type":"boolean"},"voiceId":{"type":"string","minLength":1,"maxLength":200},"language":{"type":"string","maxLength":12,"pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"consentCopy":{"type":"string","minLength":1,"maxLength":1000},"maxDurationSeconds":{"type":"integer","minimum":30,"maximum":3600}},"required":["enabled","language","consentCopy","maxDurationSeconds"],"additionalProperties":false},"learningConfig":{"type":"object","properties":{"captureEnabled":{"type":"boolean"}},"additionalProperties":false},"escalationTeamId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"chatPageEnabled":{"type":"boolean"},"chatPageBlockedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"indexable":{"type":"boolean"},"emailFromName":{"anyOf":[{"type":"string"},{"type":"null"}]},"deletionScheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"deletionRequestedBy":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","name","systemPrompt","status","inTransfer","model","temperature","rateLimitPerMinute","allowedDomains","widgetConfig","notifyConfig","voiceConfig","learningConfig","escalationTeamId","supportEmail","website","logoUrl","chatPageEnabled","chatPageBlockedAt","indexable","emailFromName","deletionScheduledAt","deletionRequestedBy","createdAt","updatedAt"],"additionalProperties":false},"createSourceResponse":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","enum":["processing","ready","error","pending"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","title","status","metadata","chunkCount","createdAt","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","const":"processing"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","type","title","status","metadata","chunkCount"],"additionalProperties":false}]},"createSourceRequest":{"type":"object","properties":{"type":{"default":"text","type":"string","enum":["text","url","qa","blog"]},"title":{"type":"string","minLength":1,"maxLength":255},"content":{"type":"string","minLength":1,"maxLength":200000},"excludePatterns":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["title","content"]},"listSourcesResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","enum":["processing","ready","error","pending"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastCrawledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"ingestClaimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","type","title","status","metadata","chunkCount","createdAt","updatedAt","lastCrawledAt","ingestClaimedAt"],"additionalProperties":false}},"readSourceContentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","enum":["processing","ready","error","pending"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"content":{"type":"string"},"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastCrawledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","type","title","status","metadata","chunkCount","createdAt","updatedAt","content","revision","lastCrawledAt"],"additionalProperties":false},"uploadSourceFileResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","enum":["processing","ready","error","pending"]},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","type","title","status","chunkCount","createdAt","updatedAt"],"additionalProperties":false},"uploadSourceFileRequest":{"type":"object","properties":{"file":{"type":"string","format":"binary","contentEncoding":"binary","minLength":1,"maxLength":10485760}},"required":["file"]},"recrawlSourceResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["url","blog"]},"title":{"type":"string"},"status":{"type":"string","const":"processing"}},"required":["id","type","title","status"],"additionalProperties":false},"updateSourceRefreshResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"refreshDisabled":{"type":"boolean"}},"required":["id","refreshDisabled"],"additionalProperties":false},"updateSourceRefreshRequest":{"type":"object","properties":{"refreshDisabled":{"type":"boolean"}},"required":["refreshDisabled"]},"updateSourceContentResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["text","url","file","qa","blog","human"]},"title":{"type":"string"},"status":{"type":"string","enum":["processing","ready","error","pending"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"chunkCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"content":{"type":"string"},"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastCrawledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","type","title","status","metadata","chunkCount","createdAt","updatedAt","content","revision","lastCrawledAt"],"additionalProperties":false},"updateSourceContentRequest":{"anyOf":[{"required":["title"]},{"required":["content"]}],"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"title":{"type":"string","minLength":1,"maxLength":255},"content":{"type":"string","minLength":1,"maxLength":200000}},"required":["revision"],"additionalProperties":false},"deleteSourceResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"deleteSourcePageResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listAgentMacrosResponse":{"type":"object","properties":{"canEdit":{"type":"boolean"},"macros":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"body":{"type":"string"},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"close":{"type":"boolean"}},"required":["labelIds","close"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"usesThisMonth":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","workspaceId","agentId","name","body","actions","createdAt","updatedAt","usesThisMonth"],"additionalProperties":false}}},"required":["canEdit","macros"],"additionalProperties":false},"createAgentMacroResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"body":{"type":"string"},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"close":{"type":"boolean"}},"required":["labelIds","close"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"usesThisMonth":{"type":"number","const":0}},"required":["id","workspaceId","agentId","name","body","actions","createdAt","updatedAt","usesThisMonth"],"additionalProperties":false},"createAgentMacroRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"body":{"type":"string","minLength":1,"maxLength":10000},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"close":{"type":"boolean"}},"additionalProperties":false}},"required":["name","body"],"additionalProperties":false},"updateAgentMacroResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"body":{"type":"string"},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"close":{"type":"boolean"}},"required":["labelIds","close"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","body","actions","createdAt","updatedAt"],"additionalProperties":false},"updateAgentMacroRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"body":{"type":"string","minLength":1,"maxLength":10000},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"close":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false},"deleteAgentMacroResponse":{"type":"null"},"recordAgentMacroUseResponse":{"type":"null"},"listAgentRulesResponse":{"type":"object","properties":{"canEdit":{"type":"boolean"},"loopGuard":{"type":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"required":["keywords","channels"],"additionalProperties":false},"actions":{"type":"object","properties":{"labelIds":{"type":"array","items":{"type":"string"}},"teamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high","urgent"]},{"type":"null"}]},"close":{"type":"boolean"}},"required":["labelIds","teamId","priority","close"],"additionalProperties":false},"enabled":{"type":"boolean"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"firesThisWeek":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","workspaceId","agentId","name","trigger","conditions","actions","enabled","position","createdAt","updatedAt","firesThisWeek"],"additionalProperties":false}}},"required":["canEdit","loopGuard","rules"],"additionalProperties":false},"createAgentRuleResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"required":["keywords","channels"],"additionalProperties":false},"actions":{"type":"object","properties":{"labelIds":{"type":"array","items":{"type":"string"}},"teamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high","urgent"]},{"type":"null"}]},"close":{"type":"boolean"}},"required":["labelIds","teamId","priority","close"],"additionalProperties":false},"enabled":{"type":"boolean"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"firesThisWeek":{"type":"number","const":0}},"required":["id","workspaceId","agentId","name","trigger","conditions","actions","enabled","position","createdAt","updatedAt","firesThisWeek"],"additionalProperties":false},"createAgentRuleRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"channels":{"maxItems":4,"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"additionalProperties":false},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"teamId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high","urgent"]},{"type":"null"}]},"close":{"type":"boolean"}},"additionalProperties":false},"enabled":{"type":"boolean"}},"required":["name","trigger","conditions","actions"],"additionalProperties":false},"updateAgentRuleResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string"}},"channels":{"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"required":["keywords","channels"],"additionalProperties":false},"actions":{"type":"object","properties":{"labelIds":{"type":"array","items":{"type":"string"}},"teamId":{"anyOf":[{"type":"string"},{"type":"null"}]},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high","urgent"]},{"type":"null"}]},"close":{"type":"boolean"}},"required":["labelIds","teamId","priority","close"],"additionalProperties":false},"enabled":{"type":"boolean"},"position":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","trigger","conditions","actions","enabled","position","createdAt","updatedAt"],"additionalProperties":false},"updateAgentRuleRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"channels":{"maxItems":4,"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"additionalProperties":false},"actions":{"type":"object","properties":{"labelIds":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"teamId":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"priority":{"anyOf":[{"type":"string","enum":["low","normal","high","urgent"]},{"type":"null"}]},"close":{"type":"boolean"}},"additionalProperties":false},"enabled":{"type":"boolean"}},"additionalProperties":false},"deleteAgentRuleResponse":{"type":"null"},"reorderAgentRulesResponse":{"type":"null"},"reorderAgentRulesRequest":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","minLength":1}}},"required":["ids"],"additionalProperties":false},"setAgentRuleLoopGuardResponse":{"type":"object","properties":{"loopGuard":{"type":"boolean"}},"required":["loopGuard"],"additionalProperties":false},"setAgentRuleLoopGuardRequest":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"listAgentRuleRunsResponse":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"ruleId":{"type":"string","minLength":1},"ruleName":{"type":"string"},"conversationId":{"type":"string","minLength":1},"firedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","ruleId","ruleName","conversationId","firedAt"],"additionalProperties":false}}},"required":["runs"],"additionalProperties":false},"previewAgentRuleResponse":{"type":"object","properties":{"matched":{"type":"integer","minimum":0,"maximum":9007199254740991},"scanned":{"type":"integer","minimum":0,"maximum":9007199254740991},"days":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["matched","scanned","days"],"additionalProperties":false},"previewAgentRuleRequest":{"type":"object","properties":{"trigger":{"type":"string","enum":["conversation_created","message_received"]},"conditions":{"type":"object","properties":{"keywords":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"channels":{"maxItems":4,"type":"array","items":{"type":"string","enum":["widget","email","api","playground"]}}},"additionalProperties":false}},"required":["trigger","conditions"],"additionalProperties":false},"readAgentSupportSettingsResponse":{"type":"object","properties":{"canEdit":{"type":"boolean"},"settings":{"type":"object","properties":{"assignment":{"type":"object","properties":{"method":{"type":"string","enum":["round_robin","fewest_open","manual"]},"limitPerPerson":{"anyOf":[{"type":"integer","minimum":1,"maximum":500},{"type":"null"}]},"onlineOnly":{"type":"boolean"}},"required":["method","limitPerPerson","onlineOnly"],"additionalProperties":false},"hours":{"type":"object","properties":{"enabled":{"type":"boolean"},"timezone":{"type":"string","minLength":1,"maxLength":64},"days":{"type":"object","properties":{"mon":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"tue":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"wed":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"thu":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"fri":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sat":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sun":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false}},"required":["mon","tue","wed","thu","fri","sat","sun"],"additionalProperties":false},"outsideHoursReply":{"type":"string","maxLength":1000}},"required":["enabled","timezone","days","outsideHoursReply"],"additionalProperties":false},"targets":{"type":"object","properties":{"firstReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]},"nextReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]}},"required":["firstReplyMinutes","nextReplyMinutes"],"additionalProperties":false},"email":{"type":"object","properties":{"ignoreAutoReplies":{"type":"boolean"},"keepCc":{"type":"boolean"}},"required":["ignoreAutoReplies","keepCc"],"additionalProperties":false},"automation":{"type":"object","properties":{"loopGuard":{"type":"boolean"}},"required":["loopGuard"],"additionalProperties":false}},"required":["assignment","hours","targets","email"],"additionalProperties":false},"signature":{"type":"string"},"mailbox":{"type":"object","properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address"],"additionalProperties":false}},"required":["canEdit","settings","signature","mailbox"],"additionalProperties":false},"updateAgentSupportSettingsResponse":{"type":"object","properties":{"settings":{"type":"object","properties":{"assignment":{"type":"object","properties":{"method":{"type":"string","enum":["round_robin","fewest_open","manual"]},"limitPerPerson":{"anyOf":[{"type":"integer","minimum":1,"maximum":500},{"type":"null"}]},"onlineOnly":{"type":"boolean"}},"required":["method","limitPerPerson","onlineOnly"],"additionalProperties":false},"hours":{"type":"object","properties":{"enabled":{"type":"boolean"},"timezone":{"type":"string","minLength":1,"maxLength":64},"days":{"type":"object","properties":{"mon":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"tue":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"wed":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"thu":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"fri":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sat":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sun":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false}},"required":["mon","tue","wed","thu","fri","sat","sun"],"additionalProperties":false},"outsideHoursReply":{"type":"string","maxLength":1000}},"required":["enabled","timezone","days","outsideHoursReply"],"additionalProperties":false},"targets":{"type":"object","properties":{"firstReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]},"nextReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]}},"required":["firstReplyMinutes","nextReplyMinutes"],"additionalProperties":false},"email":{"type":"object","properties":{"ignoreAutoReplies":{"type":"boolean"},"keepCc":{"type":"boolean"}},"required":["ignoreAutoReplies","keepCc"],"additionalProperties":false},"automation":{"type":"object","properties":{"loopGuard":{"type":"boolean"}},"required":["loopGuard"],"additionalProperties":false}},"required":["assignment","hours","targets","email"],"additionalProperties":false}},"required":["settings"],"additionalProperties":false},"updateAgentSupportSettingsRequest":{"type":"object","properties":{"assignment":{"type":"object","properties":{"method":{"type":"string","enum":["round_robin","fewest_open","manual"]},"limitPerPerson":{"anyOf":[{"type":"integer","minimum":1,"maximum":500},{"type":"null"}]},"onlineOnly":{"type":"boolean"}},"required":["method","limitPerPerson","onlineOnly"],"additionalProperties":false},"hours":{"type":"object","properties":{"enabled":{"type":"boolean"},"timezone":{"type":"string","minLength":1,"maxLength":64},"days":{"type":"object","properties":{"mon":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"tue":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"wed":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"thu":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"fri":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sat":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false},"sun":{"type":"object","properties":{"open":{"type":"boolean"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["open","start","end"],"additionalProperties":false}},"required":["mon","tue","wed","thu","fri","sat","sun"],"additionalProperties":false},"outsideHoursReply":{"type":"string","maxLength":1000}},"required":["enabled","timezone","days","outsideHoursReply"],"additionalProperties":false},"targets":{"type":"object","properties":{"firstReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]},"nextReplyMinutes":{"anyOf":[{"type":"integer","minimum":1,"maximum":10080},{"type":"null"}]}},"required":["firstReplyMinutes","nextReplyMinutes"],"additionalProperties":false},"email":{"type":"object","properties":{"ignoreAutoReplies":{"type":"boolean"},"keepCc":{"type":"boolean"}},"required":["ignoreAutoReplies","keepCc"],"additionalProperties":false},"automation":{"type":"object","properties":{"loopGuard":{"type":"boolean"}},"required":["loopGuard"],"additionalProperties":false}},"required":["assignment","hours","targets","email"],"additionalProperties":false},"setAgentSupportSignatureResponse":{"type":"object","properties":{"signature":{"type":"string","maxLength":2000}},"required":["signature"],"additionalProperties":false},"setAgentSupportSignatureRequest":{"type":"object","properties":{"signature":{"type":"string","maxLength":2000}},"required":["signature"],"additionalProperties":false},"listLinkedAgentsResponse":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"readLinkedAgentResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readLinkedAgentSettingsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listLinkedAgentActionsResponse":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"listLinkedAgentSourcesResponse":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"setLinkedAgentAiSettingsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setLinkedAgentAiSettingsRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":{}},"setLinkedAgentWidgetSettingsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setLinkedAgentWidgetSettingsRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":{}},"setLinkedAgentPauseResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setLinkedAgentPauseRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"paused":{"type":"boolean"}},"required":["revision","paused"],"additionalProperties":false},"updateLinkedAgentActionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateLinkedAgentActionRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":{}},"createLinkedAgentSourceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createLinkedAgentSourceRequest":{"type":"object","properties":{"type":{"type":"string","enum":["text","qa","url","blog"]},"title":{"type":"string","minLength":1,"maxLength":255},"content":{"type":"string","minLength":1,"maxLength":200000},"authorityConfirmed":{"type":"boolean","const":true}},"required":["type","title","content","authorityConfirmed"],"additionalProperties":false},"updateLinkedAgentSourceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateLinkedAgentSourceRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":{}},"retrainLinkedAgentSourceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"retrainLinkedAgentSourceRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":false},"enableLinkedAgentSourceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enableLinkedAgentSourceRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":false},"disableLinkedAgentSourceResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"disableLinkedAgentSourceRequest":{"type":"object","properties":{"revision":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["revision"],"additionalProperties":false},"unlinkLinkedAgentResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"assignLinkedAgentMemberResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"assignLinkedAgentMemberRequest":{"type":"object","properties":{"memberId":{"type":"string","minLength":1}},"required":["memberId"],"additionalProperties":false},"unassignLinkedAgentMemberResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listLearningsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"type":"string"},"answer":{"type":"string"},"status":{"type":"string","enum":["pending","conflicted","published","superseded","rejected"]},"timesSeen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"capturedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"supersedesId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["id","question","answer","status","timesSeen","capturedAt","supersedesId"],"additionalProperties":false}},"approveLearningResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false},"rejectLearningResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false},"readActiveGrillRoundResponse":{"type":"object","properties":{"round":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["active","complete"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","agentId","size","status","createdAt","updatedAt","completedAt"],"additionalProperties":false},{"type":"null"}]},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false}},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["round","questions","balance"],"additionalProperties":false},"createGrillRoundResponse":{"type":"object","properties":{"round":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["active","complete"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","agentId","size","status","createdAt","updatedAt","completedAt"],"additionalProperties":false},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false}},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["round","questions","balance"],"additionalProperties":false},"createGrillRoundRequest":{"type":"object","properties":{"size":{"enum":[5,10,15,20,25],"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["size"]},"readGrillRoundResponse":{"type":"object","properties":{"round":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["active","complete"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","workspaceId","agentId","size","status","createdAt","updatedAt","completedAt"],"additionalProperties":false},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false}},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["round","questions","balance"],"additionalProperties":false},"answerGrillQuestionResponse":{"type":"object","properties":{"question":{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false}},"required":["question"],"additionalProperties":false},"answerGrillQuestionRequest":{"type":"object","properties":{"answer":{"type":"string","maxLength":20000}},"required":["answer"]},"draftGrillAnswerResponse":{"type":"object","properties":{"draft":{"type":"string"},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["draft","balance"],"additionalProperties":false},"skipGrillQuestionResponse":{"type":"object","properties":{"skippedId":{"type":"string","minLength":1},"replacement":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false},{"type":"null"}]},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["skippedId","replacement","balance"],"additionalProperties":false},"regenerateGrillQuestionResponse":{"type":"object","properties":{"question":{"type":"object","properties":{"id":{"type":"string","minLength":1},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"question":{"type":"string"},"answer":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["unanswered","answered","skipped"]}},"required":["id","position","question","answer","state"],"additionalProperties":false},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["question","balance"],"additionalProperties":false},"finishGrillRoundResponse":{"type":"object","properties":{"saved":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["saved"],"additionalProperties":false},"readNotificationPublicKeyResponse":{"type":"object","properties":{"publicKey":{"type":"string"}},"required":["publicKey"],"additionalProperties":false},"listNotificationDevicesResponse":{"type":"object","properties":{"devices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"status":{"type":"string","enum":["enabled","expired","attention"]},"lastActiveAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"needsAttention":{"type":"boolean"},"failureClass":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","label","status","lastActiveAt","lastSuccessAt","needsAttention","failureClass"],"additionalProperties":false}}},"required":["devices"],"additionalProperties":false},"readNotificationBadgeResponse":{"type":"object","properties":{"count":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["count"],"additionalProperties":false},"registerNotificationDeviceResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"status":{"type":"string","const":"enabled"}},"required":["id","label","status"],"additionalProperties":false},"registerNotificationDeviceRequest":{"type":"object","properties":{"endpoint":{"type":"string","minLength":1,"maxLength":2048},"keys":{"type":"object","properties":{"p256dh":{"type":"string","maxLength":87},"auth":{"type":"string","maxLength":22}},"required":["p256dh","auth"]}},"required":["endpoint","keys"]},"renameNotificationDeviceResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"additionalProperties":false},"renameNotificationDeviceRequest":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":64}},"required":["label"]},"deleteNotificationDeviceResponse":{"type":"null"},"readNotificationSettingsResponse":{"type":"object","properties":{"configured":{"type":"boolean"},"preferences":{"type":"object","properties":{"pushEnabled":{"type":"boolean"},"notifyNewMessage":{"type":"boolean"},"notifyHandoff":{"type":"boolean"},"notifyAssignment":{"type":"boolean"},"agentScope":{"type":"string","enum":["all","selected"]},"selectedAgentIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1}},"showPreview":{"type":"boolean"},"soundEnabled":{"type":"boolean"},"bannerDismissed":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["pushEnabled","notifyNewMessage","notifyHandoff","notifyAssignment","agentScope","selectedAgentIds","showPreview","soundEnabled","bannerDismissed","revision"],"additionalProperties":false},"agents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"devices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"status":{"type":"string","enum":["enabled","expired","attention"]},"lastActiveAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"needsAttention":{"type":"boolean"},"failureClass":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","label","status","lastActiveAt","lastSuccessAt","needsAttention","failureClass"],"additionalProperties":false}}},"required":["configured","preferences","agents","devices"],"additionalProperties":false},"updateNotificationSettingsResponse":{"type":"object","properties":{"pushEnabled":{"type":"boolean"},"notifyNewMessage":{"type":"boolean"},"notifyHandoff":{"type":"boolean"},"notifyAssignment":{"type":"boolean"},"agentScope":{"type":"string","enum":["all","selected"]},"selectedAgentIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1}},"showPreview":{"type":"boolean"},"soundEnabled":{"type":"boolean"},"bannerDismissed":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["pushEnabled","notifyNewMessage","notifyHandoff","notifyAssignment","agentScope","selectedAgentIds","showPreview","soundEnabled","bannerDismissed","revision"],"additionalProperties":false},"updateNotificationSettingsRequest":{"type":"object","properties":{"pushEnabled":{"type":"boolean"},"notifyNewMessage":{"type":"boolean"},"notifyHandoff":{"type":"boolean"},"notifyAssignment":{"type":"boolean"},"agentScope":{"type":"string","enum":["all","selected"]},"selectedAgentIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1}},"showPreview":{"type":"boolean"},"soundEnabled":{"type":"boolean"},"bannerDismissed":{"type":"boolean"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["revision"]},"updateNotificationVisibilityResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"visibleUntil":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["ok"],"additionalProperties":false},"updateNotificationVisibilityRequest":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1,"maxLength":200},"visible":{"type":"boolean"}},"required":["conversationId","visible"]},"sendNotificationTestResponse":{"type":"object","properties":{"status":{"type":"string","const":"accepted"}},"required":["status"],"additionalProperties":false},"sendNotificationTestRequest":{"type":"object","properties":{"subscriptionId":{"type":"string","minLength":1,"maxLength":200},"testId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["subscriptionId"]},"readNotificationMemberSummaryResponse":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"memberId":{"type":"string","minLength":1},"enabled":{"type":"boolean"}},"required":["memberId","enabled"],"additionalProperties":false}}},"required":["members"],"additionalProperties":false},"listActionsResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string"},"paramSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"headersConfigured":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","description","method","urlTemplate","paramSchema","bodyTemplate","headersConfigured","createdAt"],"additionalProperties":false}},"createActionResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string"},"paramSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"headersConfigured":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","description","method","urlTemplate","paramSchema","bodyTemplate","headersConfigured","createdAt"],"additionalProperties":false},"createActionRequest":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z0-9_]{1,64}$"},"description":{"type":"string","minLength":1,"maxLength":1000},"method":{"default":"GET","type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string","format":"uri"},"headers":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"paramSchema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"default":null,"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["name","description","urlTemplate"],"additionalProperties":false},"createActionsBatchResponse":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string"},"paramSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"headersConfigured":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","description","method","urlTemplate","paramSchema","bodyTemplate","headersConfigured","createdAt"],"additionalProperties":false}},"createActionsBatchRequest":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z0-9_]{1,64}$"},"description":{"type":"string","minLength":1,"maxLength":1000},"method":{"default":"GET","type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string","format":"uri"},"headers":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"paramSchema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"default":null,"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["name","description","urlTemplate"],"additionalProperties":false}},"updateActionResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string"},"paramSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"headersConfigured":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","description","method","urlTemplate","paramSchema","bodyTemplate","headersConfigured","createdAt"],"additionalProperties":false},"updateActionRequest":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z0-9_]{1,64}$"},"description":{"type":"string","minLength":1,"maxLength":1000},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"urlTemplate":{"type":"string","format":"uri"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"paramSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"bodyTemplate":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":false},"deleteActionResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"startCalendlyAuthorizationResponse":{"type":"object","properties":{"authorizationUrl":{"type":"string","format":"uri"}},"required":["authorizationUrl"],"additionalProperties":false},"completeCalendlyAuthorizationResponse":{"type":"object","properties":{"message":{"type":"string"},"integration":{"type":"object","properties":{"id":{"type":"string","minLength":1},"connectionId":{"type":"string","minLength":1},"providerKey":{"type":"string","enum":["cal","calendly"]},"providerLabel":{"type":"string"},"authType":{"type":"string","enum":["oauth2","api_key","personal_access_token"]},"enabled":{"type":"boolean"},"capabilityKeys":{"type":"array","items":{"type":"string"}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"connectionStatus":{"type":"string","enum":["pending","active","error","revoked"]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"connectedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","connectionId","providerKey","providerLabel","authType","enabled","capabilityKeys","config","connectionStatus","displayName","externalAccountId","lastErrorCode","connectedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["message","integration"],"additionalProperties":false},"completeCalendlyAuthorizationRequest":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":2000},"state":{"type":"string","minLength":1,"maxLength":8000},"enabled":{"type":"boolean"},"capabilityKeys":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["code","state"],"additionalProperties":false},"createIntegrationResponse":{"type":"object","properties":{"message":{"type":"string"},"integration":{"type":"object","properties":{"id":{"type":"string","minLength":1},"connectionId":{"type":"string","minLength":1},"providerKey":{"type":"string","enum":["cal","calendly"]},"providerLabel":{"type":"string"},"authType":{"type":"string","enum":["oauth2","api_key","personal_access_token"]},"enabled":{"type":"boolean"},"capabilityKeys":{"type":"array","items":{"type":"string"}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"connectionStatus":{"type":"string","enum":["pending","active","error","revoked"]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"connectedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","connectionId","providerKey","providerLabel","authType","enabled","capabilityKeys","config","connectionStatus","displayName","externalAccountId","lastErrorCode","connectedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["message","integration"],"additionalProperties":false},"createIntegrationRequest":{"type":"object","properties":{"providerKey":{"type":"string","enum":["cal","calendly"]},"enabled":{"type":"boolean"},"capabilityKeys":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"credentials":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["providerKey","credentials"],"additionalProperties":false},"listIntegrationsResponse":{"type":"object","properties":{"canEdit":{"type":"boolean"},"catalog":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["cal","calendly","shopify"]},"label":{"type":"string"},"releaseState":{"type":"string","enum":["stable","beta"]},"setupHref":{"type":"string","const":"/dashboard/settings/shopify"},"auth":{"type":"object","properties":{"type":{"type":"string","enum":["api_key","personal_access_token","managed_installation"]},"label":{"type":"string"},"oauth":{"type":"boolean"}},"required":["type","label","oauth"],"additionalProperties":false},"capabilities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"toolName":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmation":{"type":"object","properties":{"required":{"type":"boolean"},"message":{"type":"string"}},"required":["required"],"additionalProperties":false}},"required":["key","toolName","description","inputSchema"],"additionalProperties":false}}},"required":["key","label","auth","capabilities"],"additionalProperties":false}},"integrations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"connectionId":{"type":"string","minLength":1},"providerKey":{"type":"string","enum":["cal","calendly"]},"providerLabel":{"type":"string"},"authType":{"type":"string","enum":["oauth2","api_key","personal_access_token"]},"enabled":{"type":"boolean"},"capabilityKeys":{"type":"array","items":{"type":"string"}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"connectionStatus":{"type":"string","enum":["pending","active","error","revoked"]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"connectedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","connectionId","providerKey","providerLabel","authType","enabled","capabilityKeys","config","connectionStatus","displayName","externalAccountId","lastErrorCode","connectedAt","createdAt","updatedAt"],"additionalProperties":false}},"shopifyBindings":{"type":"array","items":{"type":"object","properties":{"installationId":{"type":"string","minLength":1},"shop":{"type":"string"},"connectionStatus":{"type":"string","enum":["active","error"]}},"required":["installationId","shop","connectionStatus"],"additionalProperties":false}}},"required":["canEdit","catalog","integrations"],"additionalProperties":false},"updateIntegrationResponse":{"type":"object","properties":{"message":{"type":"string"},"integration":{"type":"object","properties":{"id":{"type":"string","minLength":1},"connectionId":{"type":"string","minLength":1},"providerKey":{"type":"string","enum":["cal","calendly"]},"providerLabel":{"type":"string"},"authType":{"type":"string","enum":["oauth2","api_key","personal_access_token"]},"enabled":{"type":"boolean"},"capabilityKeys":{"type":"array","items":{"type":"string"}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"connectionStatus":{"type":"string","enum":["pending","active","error","revoked"]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"connectedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","connectionId","providerKey","providerLabel","authType","enabled","capabilityKeys","config","connectionStatus","displayName","externalAccountId","lastErrorCode","connectedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["message","integration"],"additionalProperties":false},"updateIntegrationRequest":{"type":"object","properties":{"enabled":{"type":"boolean"},"capabilityKeys":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"testIntegrationResponse":{"type":"object","properties":{"message":{"type":"string"},"integration":{"type":"object","properties":{"id":{"type":"string","minLength":1},"connectionId":{"type":"string","minLength":1},"providerKey":{"type":"string","enum":["cal","calendly"]},"providerLabel":{"type":"string"},"authType":{"type":"string","enum":["oauth2","api_key","personal_access_token"]},"enabled":{"type":"boolean"},"capabilityKeys":{"type":"array","items":{"type":"string"}},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"connectionStatus":{"type":"string","enum":["pending","active","error","revoked"]},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"externalAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"connectedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["id","connectionId","providerKey","providerLabel","authType","enabled","capabilityKeys","config","connectionStatus","displayName","externalAccountId","lastErrorCode","connectedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["message","integration"],"additionalProperties":false},"deleteIntegrationResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true},"message":{"type":"string"}},"required":["deleted","message"],"additionalProperties":false},"listOutboundCampaignsResponse":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","scheduled","paused","sent"]},"channel":{"type":"string","enum":["whatsapp","email"]},"audience":{"type":"string","enum":["all_contacts","manual"]},"templateName":{"type":"string"},"templateBody":{"type":"string"},"recipientCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deliveredCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"readCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"replyCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","channel","audience","templateName","templateBody","recipientCount","deliveredCount","readCount","replyCount","scheduledAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["campaigns"],"additionalProperties":false},"createOutboundCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","scheduled","paused","sent"]},"channel":{"type":"string","enum":["whatsapp","email"]},"audience":{"type":"string","enum":["all_contacts","manual"]},"templateName":{"type":"string"},"templateBody":{"type":"string"},"recipientCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deliveredCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"readCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"replyCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","channel","audience","templateName","templateBody","recipientCount","deliveredCount","readCount","replyCount","scheduledAt","createdAt","updatedAt"],"additionalProperties":false},"createOutboundCampaignRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"channel":{"default":"whatsapp","type":"string","enum":["whatsapp","email"]},"audience":{"default":"all_contacts","type":"string","enum":["all_contacts","manual"]},"templateName":{"type":"string","minLength":1,"maxLength":120},"templateBody":{"type":"string","minLength":1,"maxLength":1000},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["name","templateName","templateBody"],"additionalProperties":false},"pauseOutboundCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","scheduled","paused","sent"]},"channel":{"type":"string","enum":["whatsapp","email"]},"audience":{"type":"string","enum":["all_contacts","manual"]},"templateName":{"type":"string"},"templateBody":{"type":"string"},"recipientCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deliveredCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"readCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"replyCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","channel","audience","templateName","templateBody","recipientCount","deliveredCount","readCount","replyCount","scheduledAt","createdAt","updatedAt"],"additionalProperties":false},"deleteOutboundCampaignResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"presignInAppImageResponse":{"type":"object","properties":{"key":{"type":"string","minLength":1},"putUrl":{"type":"string","format":"uri"},"headers":{"type":"object","properties":{"Content-Type":{"type":"string"}},"required":["Content-Type"],"additionalProperties":false}},"required":["key","putUrl","headers"],"additionalProperties":false},"presignInAppImageRequest":{"type":"object","properties":{"nudgeId":{"type":"string","minLength":1,"maxLength":128},"filename":{"type":"string","minLength":1,"maxLength":255},"contentType":{"type":"string","minLength":1,"maxLength":255},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["filename","contentType","sizeBytes"],"additionalProperties":false},"confirmInAppImageResponse":{"type":"object","properties":{"key":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"contentType":{"type":"string"},"sizeBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["key","url","contentType","sizeBytes"],"additionalProperties":false},"confirmInAppImageRequest":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":1024}},"required":["key"],"additionalProperties":false},"createInAppCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","live","paused","archived"]},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","surface","priority","content","targeting","frequency","delaySeconds","scheduledAt","expiresAt","publishedAt","createdAt","updatedAt"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignResponse/$defs/__schema1"}}]}}},"createInAppCampaignRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"status":{"type":"string","enum":["draft","live","paused","archived"]},"priority":{"type":"integer","minimum":0,"maximum":1000},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":0,"maximum":86400},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["name","surface"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createInAppCampaignRequest/$defs/__schema1"}}]}}},"updateInAppCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","live","paused","archived"]},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","surface","priority","content","targeting","frequency","delaySeconds","scheduledAt","expiresAt","publishedAt","createdAt","updatedAt"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignResponse/$defs/__schema1"}}]}}},"updateInAppCampaignRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"status":{"type":"string","enum":["draft","live","paused","archived"]},"priority":{"type":"integer","minimum":0,"maximum":1000},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":0,"maximum":86400},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/updateInAppCampaignRequest/$defs/__schema1"}}]}}},"listInAppCampaignsResponse":{"type":"object","properties":{"nudges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","live","paused","archived"]},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","surface","priority","content","targeting","frequency","delaySeconds","scheduledAt","expiresAt","publishedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["nudges"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/listInAppCampaignsResponse/$defs/__schema1"}}]}}},"readInAppCampaignAnalyticsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"getInAppCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","live","paused","archived"]},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","surface","priority","content","targeting","frequency","delaySeconds","scheduledAt","expiresAt","publishedAt","createdAt","updatedAt"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/getInAppCampaignResponse/$defs/__schema1"}}]}}},"duplicateInAppCampaignResponse":{"type":"object","properties":{"id":{"type":"string","minLength":1},"workspaceId":{"type":"string","minLength":1},"agentId":{"type":"string","minLength":1},"name":{"type":"string"},"status":{"type":"string","enum":["draft","live","paused","archived"]},"surface":{"type":"string","enum":["floating_card","in_panel","toast"]},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema0"}},"targeting":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema1"}},"frequency":{"type":"string","enum":["once","every_session","always"]},"delaySeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","workspaceId","agentId","name","status","surface","priority","content","targeting","frequency","delaySeconds","scheduledAt","expiresAt","publishedAt","createdAt","updatedAt"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema0"}}]},"__schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/duplicateInAppCampaignResponse/$defs/__schema1"}}]}}},"deleteInAppCampaignResponse":{"anyOf":[{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},{"type":"object","properties":{"archived":{"type":"boolean","const":true}},"required":["archived"],"additionalProperties":false}]},"requestAgentDeletionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmAgentDeletionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmAgentDeletionRequest":{"type":"object","properties":{"otp":{"type":"string","pattern":"^\\d{6}$"}},"required":["otp"],"additionalProperties":false},"cancelAgentDeletionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"deleteHelpArticleResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createAgentGrantRequest":{"type":"object","properties":{"recipientEmail":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"permissionLevel":{"type":"string","enum":["operate","manage"]}},"required":["recipientEmail","permissionLevel"],"additionalProperties":false},"updateAgentGrantPermissionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateAgentGrantPermissionRequest":{"type":"object","properties":{"permissionLevel":{"type":"string","enum":["operate","manage"]}},"required":["permissionLevel"],"additionalProperties":false},"resendAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cancelAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"revokeAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"acceptLinkedAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"acceptLinkedAgentGrantRequest":{"type":"object","properties":{"destinationWorkspaceId":{"type":"string","minLength":1}},"required":["destinationWorkspaceId"],"additionalProperties":false},"declineLinkedAgentGrantResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"previewAgentTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createAgentTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createAgentTransferRequest":{"type":"object","properties":{"recipientEmail":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["recipientEmail"],"additionalProperties":false},"cancelAgentTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listWorkspaceTransfersResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listIncomingTransfersResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readIncomingTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"acceptAgentTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"acceptAgentTransferRequest":{"type":"object","properties":{"workspaceId":{"type":"string","minLength":1}},"required":["workspaceId"],"additionalProperties":false},"declineAgentTransferResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startPlaygroundVoiceSessionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startPlaygroundVoiceSessionRequest":{"type":"object","properties":{"consent":{"type":"boolean","const":true},"idempotencyKey":{"type":"string","minLength":8,"maxLength":128},"conversationId":{"type":"string","minLength":1,"maxLength":200}},"required":["consent","idempotencyKey"],"additionalProperties":false},"readWidgetIdentityResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateWidgetIdentityResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updateWidgetIdentityRequest":{"type":"object","properties":{"enabled":{"type":"boolean"},"mergeHistory":{"type":"boolean"}},"additionalProperties":false},"rotateWidgetIdentitySecretResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"listApiKeysResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createApiKeyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createApiKeyRequest":{"type":"object","properties":{"name":{"type":"string","minLength":5,"maxLength":300},"scopes":{"minItems":1,"type":"array","items":{"type":"string"}}},"required":["name"],"additionalProperties":false},"revokeApiKeyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"deleteApiKeyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startPlanCheckoutResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startPlanCheckoutRequest":{"type":"object","properties":{"planId":{"type":"string","minLength":1},"interval":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["planId","interval"],"additionalProperties":false},"startTopUpCheckoutResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startTopUpCheckoutRequest":{"type":"object","properties":{"packId":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["packId"],"additionalProperties":false},"previewPlanChangeResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"previewPlanChangeRequest":{"type":"object","properties":{"planId":{"type":"string","minLength":1},"interval":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["planId","interval"],"additionalProperties":false},"changePlanResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"changePlanRequest":{"type":"object","properties":{"planId":{"type":"string","minLength":1},"interval":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["planId","interval"],"additionalProperties":false},"cancelSubscriptionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cancelSubscriptionRequest":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"additionalProperties":false},"resumeSubscriptionResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"resumeSubscriptionRequest":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"additionalProperties":false},"updatePaymentMethodResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"updatePaymentMethodRequest":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["requestId"],"additionalProperties":false},"setAutoTopUpResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"setAutoTopUpRequest":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":{}},"exportWorkspaceDataResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"eraseWorkspaceConversationsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"eraseSupportEvidencePayloadResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"eraseSupportEvidencePayloadRequest":{"type":"object","properties":{"expectedLifecycleVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","minLength":1,"maxLength":1000},"observedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["expectedLifecycleVersion","idempotencyKey","reason"],"additionalProperties":false},"refreshAgentInsightsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"refreshAgentInsightsRequest":{"type":"object","properties":{"agentId":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["agentId","requestId"],"additionalProperties":{}},"refreshLinkedInsightsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"refreshLinkedInsightsRequest":{"type":"object","properties":{"agentId":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["agentId","requestId"],"additionalProperties":{}},"setClassificationPolicyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"startClassificationJobResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"classifyConversationManuallyResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"renameAnalyticsTopicResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"archiveAnalyticsTopicResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"mergeAnalyticsTopicsResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"previewTopicReprocessResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"confirmTopicReprocessResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"readTopicReprocessStatusResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cancelTopicReprocessResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"AccountCredentialBootstrap":{"type":"object","properties":{"name":{"type":"string","minLength":5,"maxLength":300},"password":{"writeOnly":true,"format":"password","type":"string","minLength":1,"maxLength":1024},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"audience":{"type":"string","enum":["https://app.communicate.so/api/v1","https://app.communicate.so/mcp"]},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["name","password","scopes","email"],"additionalProperties":false},"AccountCredentialCreate":{"type":"object","properties":{"name":{"type":"string","minLength":5,"maxLength":300},"password":{"writeOnly":true,"format":"password","type":"string","minLength":1,"maxLength":1024},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"audience":{"type":"string","enum":["https://app.communicate.so/api/v1","https://app.communicate.so/mcp"]}},"required":["name","password","scopes"],"additionalProperties":false},"AccountCredentialProof":{"type":"object","properties":{"password":{"writeOnly":true,"format":"password","type":"string","minLength":1,"maxLength":1024}},"required":["password"],"additionalProperties":false},"AccountCredentialEdit":{"type":"object","properties":{"password":{"writeOnly":true,"format":"password","type":"string","minLength":1,"maxLength":1024},"name":{"type":"string","minLength":5,"maxLength":300},"scopes":{"minItems":1,"maxItems":33,"type":"array","items":{"type":"string","enum":["workspaces:read","workspaces:write","workspaces:manage","members:read","members:write","teams:read","teams:write","invites:accept","agents:read","agents:write","sources:read","sources:write","learnings:read","learnings:write","grill:read","grill:write","notifications:read","notifications:write","inbox:read","inbox:write","credentials:read","credentials:write","analytics:read","billing:read","analytics:write","billing:write","agents:delete","agents:share","agents:transfer","agents:voice","api-keys:manage","compliance:manage","widget-identity:manage"]}},"expiresAt":{"description":"Future expiry no later than the existing credential expiry.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["password"],"additionalProperties":false,"description":"Provide at least one of name, scopes or expiresAt, plus password. Scopes must be a subset of the current scopes; expiry must be future and no later than the current expiry."},"WorkspaceCreate":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255}},"required":["name"]},"OAuthTokenResponse":{"type":"object","additionalProperties":false,"required":["access_token","token_type","expires_in","scope"],"properties":{"access_token":{"type":"string"},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer","const":3600},"scope":{"type":"string"}}},"OAuthErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string"}}},"AgentSummary":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["active","inactive","draft"]}},"required":["id","name","status"],"additionalProperties":false},"CapabilityDocument":{"type":"object","properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"coverage":{"type":"string","enum":["partial","complete"]},"operations":{"type":"array","items":{"type":"object","properties":{"operationId":{"type":"string"},"summary":{"type":"string"},"credentialKind":{"type":"string","enum":["public","password-proof","workspace-key-or-oauth-token","verified-session","verified-session-with-fresh-proof","account-key-or-session"]},"scopes":{"type":"array","items":{"type":"string"}},"readOnly":{"type":"boolean"},"api":{"type":"object","properties":{"supported":{"type":"boolean"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"]},"path":{"type":"string"},"successStatus":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"successStatuses":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"requestBodyProperty":{"type":"string"},"requestMediaType":{"type":"string","enum":["application/json","multipart/form-data"]}},"required":["supported","method","path"],"additionalProperties":false},"cli":{"type":"object","properties":{"supported":{"type":"boolean"},"command":{"type":"string"}},"required":["supported","command"],"additionalProperties":false},"mcp":{"type":"object","properties":{"supported":{"type":"boolean"},"tool":{"type":"string"}},"required":["supported","tool"],"additionalProperties":false},"inputSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"outputSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["operationId","summary","credentialKind","scopes","readOnly","api","cli","mcp","inputSchema","outputSchema"],"additionalProperties":false}}},"required":["schemaVersion","coverage","operations"],"additionalProperties":false},"ChatRequest":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","minLength":1,"maxLength":4000,"description":"End-user prompt sent to the agent."},"requestId":{"type":"string","format":"uuid","description":"Optional idempotency key for safe retries of the same chat input."},"conversationId":{"type":["string","null"],"description":"Continue an existing API-channel conversation when present."}}},"Citation":{"type":"object","additionalProperties":false,"required":["sourceId","title","snippet","url"],"properties":{"sourceId":{"type":"string"},"title":{"type":"string"},"snippet":{"type":"string"},"url":{"type":["string","null"]}}},"ChatResponse":{"type":"object","additionalProperties":false,"required":["conversationId","messageId","userMessageId","answer","citations","mode"],"properties":{"conversationId":{"type":"string"},"ticketNumber":{"type":["integer","null"]},"messageId":{"type":"string"},"userMessageId":{"type":"string"},"answer":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/Citation"}},"mode":{"type":"string","enum":["ai","human"]},"actionName":{"type":"string","description":"Present when a workspace action produced the final answer."},"followUps":{"type":"array","items":{"type":"string"},"maxItems":3,"description":"Optional suggested next questions returned with the answer."}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error","code"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"reason":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message","path"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"type":"string"}}}}}}}}}