@lessly/sdk-app 30.2.1 → 30.3.0

package/src/gen/types.gen.ts

@@ -14657,6 +14657,1516 @@ updatedAt: string
 description: (string | null)
 }
 
+export interface SupportAgentCreateInput {
+/**
+ * Job title shown under the name, e.g. "Support engineer"
+ */
+title?: string
+/**
+ * Absolute URL of the agent avatar image
+ */
+avatarUrl?: string
+/**
+ * Name the end user sees next to this agent replies
+ */
+displayName: string
+/**
+ * Lessly identity to bind this profile to, stored verbatim as an opaque string. It is never resolved, validated against the platform or enriched. Omit it for a bot or a backend profile. At most one agent per product may claim a given Lessly user
+ */
+lesslyUserId?: string
+}
+
+export interface SupportAgentCreateOutput {
+/**
+ * Agent id
+ */
+id: string
+/**
+ * Job title shown under the name, or null if unset
+ */
+title: (string | null)
+/**
+ * A deactivated agent keeps its history but can no longer be put on a thread
+ */
+isActive: boolean
+/**
+ * Avatar image URL, or null if unset
+ */
+avatarUrl: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * Name shown next to the agent replies
+ */
+displayName: string
+/**
+ * Bound Lessly identity, stored verbatim and resolved by nobody. Null for an unbound profile — a bot or the client's own backend, which replies just like anyone else
+ */
+lesslyUserId: (string | null)
+}
+
+export interface SupportAgentGetInput {
+/**
+ * Agent id
+ */
+id: string
+}
+
+export interface SupportAgentGetOutput {
+/**
+ * Agent id
+ */
+id: string
+/**
+ * Job title shown under the name, or null if unset
+ */
+title: (string | null)
+/**
+ * A deactivated agent keeps its history but can no longer be put on a thread
+ */
+isActive: boolean
+/**
+ * Avatar image URL, or null if unset
+ */
+avatarUrl: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * Name shown next to the agent replies
+ */
+displayName: string
+/**
+ * Bound Lessly identity, stored verbatim and resolved by nobody. Null for an unbound profile — a bot or the client's own backend, which replies just like anyone else
+ */
+lesslyUserId: (string | null)
+}
+
+export interface SupportAgentListInput {
+/**
+ * Also return deactivated agents (default false)
+ */
+includeInactive?: boolean
+}
+
+export interface SupportAgentListOutput {
+/**
+ * The product support agents, by display name
+ */
+agents: {
+/**
+ * Agent id
+ */
+id: string
+/**
+ * Job title shown under the name, or null if unset
+ */
+title: (string | null)
+/**
+ * A deactivated agent keeps its history but can no longer be put on a thread
+ */
+isActive: boolean
+/**
+ * Avatar image URL, or null if unset
+ */
+avatarUrl: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * Name shown next to the agent replies
+ */
+displayName: string
+/**
+ * Bound Lessly identity, stored verbatim and resolved by nobody. Null for an unbound profile — a bot or the client's own backend, which replies just like anyone else
+ */
+lesslyUserId: (string | null)
+}[]
+}
+
+export interface SupportAgentUpdateInput {
+/**
+ * Agent id
+ */
+id: string
+/**
+ * New job title, or null to clear it
+ */
+title?: (string | null)
+/**
+ * Deactivate or reactivate. A deactivated agent keeps every message it wrote and every thread it already sits on, but cannot be assigned to another one
+ */
+isActive?: boolean
+/**
+ * New avatar URL, or null to clear it
+ */
+avatarUrl?: (string | null)
+/**
+ * Name the end user sees next to this agent replies
+ */
+displayName?: string
+/**
+ * Lessly identity to bind, or null to unbind. Stored verbatim, resolved by nobody
+ */
+lesslyUserId?: (string | null)
+}
+
+export interface SupportAgentUpdateOutput {
+/**
+ * Agent id
+ */
+id: string
+/**
+ * Job title shown under the name, or null if unset
+ */
+title: (string | null)
+/**
+ * A deactivated agent keeps its history but can no longer be put on a thread
+ */
+isActive: boolean
+/**
+ * Avatar image URL, or null if unset
+ */
+avatarUrl: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * Name shown next to the agent replies
+ */
+displayName: string
+/**
+ * Bound Lessly identity, stored verbatim and resolved by nobody. Null for an unbound profile — a bot or the client's own backend, which replies just like anyone else
+ */
+lesslyUserId: (string | null)
+}
+
+export interface SupportAttachmentCreateInput {
+/**
+ * Display name of the file, e.g. "invoice.pdf". Only the base name is used for the storage key; any directory part is discarded
+ */
+fileName: string
+/**
+ * Thread the file belongs to. An attachment is created against a thread first and claimed by one of its messages later, when that message is posted
+ */
+threadId: string
+/**
+ * Size of the file in bytes, at most 26214400. Declared up front so an oversized upload is refused before a URL is issued; finalize checks the real size again
+ */
+sizeBytes: number
+/**
+ * MIME type of the file. The upload URL is signed for exactly this type, so the PUT must send the same Content-Type header or storage rejects it
+ */
+contentType: string
+}
+
+export interface SupportAttachmentCreateOutput {
+/**
+ * Attachment id
+ */
+id: string
+/**
+ * pending: the row exists and an upload URL was issued, but no bytes have been confirmed. uploaded: finalize saw the object in storage. Only uploaded attachments can be attached to a message or downloaded
+ */
+status: ("pending" | "uploaded")
+/**
+ * Display name of the file
+ */
+fileName: string
+/**
+ * Thread this attachment belongs to
+ */
+threadId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * The message that carries this attachment, or null while nothing claims it yet
+ */
+messageId: (string | null)
+/**
+ * Size in bytes: what the caller declared while the attachment is pending, what storage reported once it is uploaded
+ */
+sizeBytes: number
+/**
+ * Short-lived signed URL. PUT the file bytes here with the same Content-Type, then call support_attachment_finalize. The URL is a bearer credential for this one object
+ */
+uploadUrl: string
+/**
+ * ISO-8601 timestamp of the confirmed upload, or null while pending
+ */
+uploadedAt: (string | null)
+/**
+ * MIME type declared when the attachment was created
+ */
+contentType: string
+/**
+ * ISO-8601 moment the upload URL stops working
+ */
+uploadExpiresAt: string
+}
+
+export interface SupportAttachmentFinalizeInput {
+/**
+ * The attachment whose upload should be confirmed, as returned by the create call
+ */
+attachmentId: string
+}
+
+export interface SupportAttachmentFinalizeOutput {
+/**
+ * Attachment id
+ */
+id: string
+/**
+ * pending: the row exists and an upload URL was issued, but no bytes have been confirmed. uploaded: finalize saw the object in storage. Only uploaded attachments can be attached to a message or downloaded
+ */
+status: ("pending" | "uploaded")
+/**
+ * Display name of the file
+ */
+fileName: string
+/**
+ * Thread this attachment belongs to
+ */
+threadId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * The message that carries this attachment, or null while nothing claims it yet
+ */
+messageId: (string | null)
+/**
+ * Size in bytes: what the caller declared while the attachment is pending, what storage reported once it is uploaded
+ */
+sizeBytes: number
+/**
+ * ISO-8601 timestamp of the confirmed upload, or null while pending
+ */
+uploadedAt: (string | null)
+/**
+ * MIME type declared when the attachment was created
+ */
+contentType: string
+/**
+ * Short-lived signed URL to read the uploaded file
+ */
+downloadUrl: string
+}
+
+export interface SupportLabelCreateInput {
+/**
+ * Label name as the customer wants to see it. Unique within the product
+ */
+name: string
+/**
+ * Optional display colour as a six-digit hex string, e.g. #2563eb
+ */
+color?: string
+}
+
+export interface SupportLabelCreateOutput {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}
+
+export interface SupportLabelListInput {
+
+}
+
+export interface SupportLabelListOutput {
+/**
+ * The product label dictionary, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+}
+
+export interface SupportMessageCreateInput {
+/**
+ * The message text, stored verbatim
+ */
+body: string
+/**
+ * Id of the thread this message belongs to
+ */
+threadId: string
+/**
+ * inbound: written by the external end user. outbound: written by support, going out to them
+ */
+direction: ("inbound" | "outbound")
+/**
+ * Defaults to public when omitted. Internal notes are never shown to the end user
+ */
+visibility?: ("public" | "internal")
+/**
+ * Files this message carries, created with support_attachment_create and confirmed with support_attachment_finalize beforehand. Each must be an uploaded attachment of the same thread that no other message already carries; otherwise the whole message is refused. At most 10 per message
+ * 
+ * @maxItems 10
+ */
+attachmentIds?: []|[string]|[string, string]|[string, string, string]|[string, string, string, string]|[string, string, string, string, string]|[string, string, string, string, string, string]|[string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string]
+/**
+ * The support agent of this product who wrote the message. Set this exactly when the message comes from inside the support contour; leave authorExternalId empty. An agent of another product is reported as not found
+ */
+authorAgentId?: string
+/**
+ * Opaque identifier of the external end user in the client's own user base, stored verbatim. Set this exactly when the message comes from outside; leave authorAgentId empty
+ */
+authorExternalId?: string
+}
+
+export interface SupportMessageCreateOutput {
+/**
+ * Message id
+ */
+id: string
+/**
+ * The message text, byte-identical to what was stored
+ */
+body: string
+/**
+ * Thread this message belongs to
+ */
+threadId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * inbound: written by the external end user. outbound: written by support, going out to them
+ */
+direction: ("inbound" | "outbound")
+/**
+ * public: part of the conversation the external end user sees. internal: a note between agents that never leaves the support contour
+ */
+visibility: ("public" | "internal")
+/**
+ * Files this message carries, each with a freshly signed download URL. Empty when there are none. Attachments whose upload was never confirmed are never listed here
+ */
+attachments: {
+/**
+ * Attachment id
+ */
+id: string
+/**
+ * Display name of the file
+ */
+fileName: string
+/**
+ * ISO-8601 timestamp of when the attachment was created
+ */
+createdAt: string
+/**
+ * Size in bytes as reported by storage
+ */
+sizeBytes: number
+/**
+ * MIME type of the file
+ */
+contentType: string
+/**
+ * Short-lived signed URL to read the file. Re-read the message to get a fresh one
+ */
+downloadUrl: string
+}[]
+/**
+ * The agent author, or null when the external end user wrote the message
+ */
+authorAgentId: (string | null)
+/**
+ * The external author, or null when an agent wrote the message
+ */
+authorExternalId: (string | null)
+}
+
+export interface SupportMessageListInput {
+/**
+ * Page size, 1..100 (default 50)
+ */
+limit?: number
+/**
+ * Number of messages to skip
+ */
+offset?: number
+/**
+ * Thread whose messages to list. Messages exist only inside a thread
+ */
+threadId: string
+/**
+ * Only messages in this direction
+ */
+direction?: ("inbound" | "outbound")
+/**
+ * Only messages with this visibility. Omit to get both public and internal
+ */
+visibility?: ("public" | "internal")
+}
+
+export interface SupportMessageListOutput {
+/**
+ * Page size that was applied
+ */
+limit: number
+/**
+ * Offset that was applied
+ */
+offset: number
+/**
+ * The requested page of messages, oldest first — the conversation reads forward
+ */
+messages: {
+/**
+ * Message id
+ */
+id: string
+/**
+ * The message text, byte-identical to what was stored
+ */
+body: string
+/**
+ * Thread this message belongs to
+ */
+threadId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * inbound: written by the external end user. outbound: written by support, going out to them
+ */
+direction: ("inbound" | "outbound")
+/**
+ * public: part of the conversation the external end user sees. internal: a note between agents that never leaves the support contour
+ */
+visibility: ("public" | "internal")
+/**
+ * Files this message carries, each with a freshly signed download URL. Empty when there are none. Attachments whose upload was never confirmed are never listed here
+ */
+attachments: {
+/**
+ * Attachment id
+ */
+id: string
+/**
+ * Display name of the file
+ */
+fileName: string
+/**
+ * ISO-8601 timestamp of when the attachment was created
+ */
+createdAt: string
+/**
+ * Size in bytes as reported by storage
+ */
+sizeBytes: number
+/**
+ * MIME type of the file
+ */
+contentType: string
+/**
+ * Short-lived signed URL to read the file. Re-read the message to get a fresh one
+ */
+downloadUrl: string
+}[]
+/**
+ * The agent author, or null when the external end user wrote the message
+ */
+authorAgentId: (string | null)
+/**
+ * The external author, or null when an agent wrote the message
+ */
+authorExternalId: (string | null)
+}[]
+}
+
+export interface SupportStatusArchiveInput {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Live status every thread on the archived status moves to, in the same transaction
+ */
+targetStatusId: string
+}
+
+export interface SupportStatusArchiveOutput {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+
+export interface SupportStatusCreateInput {
+/**
+ * Status name as the customer wants to see it. Unique within the product
+ */
+name: string
+/**
+ * Display colour as a six-digit hex string, e.g. #2563eb
+ */
+color: string
+/**
+ * Sort order within the status dictionary, lowest first
+ */
+order: number
+/**
+ * Lifecycle bucket the status belongs to. Automation and reporting read the category, never the name — so it cannot be changed once threads sit on the status
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+
+export interface SupportStatusCreateOutput {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+
+export interface SupportStatusListInput {
+/**
+ * Also return archived statuses (default false)
+ */
+includeArchived?: boolean
+}
+
+export interface SupportStatusListOutput {
+/**
+ * The product status dictionary, in display order
+ */
+statuses: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}[]
+}
+
+export interface SupportStatusUpdateInput {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name as the customer wants to see it. Unique within the product
+ */
+name?: string
+/**
+ * Display colour as a six-digit hex string, e.g. #2563eb
+ */
+color?: string
+/**
+ * Sort order within the status dictionary, lowest first
+ */
+order?: number
+/**
+ * New lifecycle bucket. Refused while any thread references the status
+ */
+category?: ("open" | "pending" | "resolved" | "closed")
+}
+
+export interface SupportStatusUpdateOutput {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+
+export interface SupportThreadAssignInput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * Support agent of this product to put on the thread, or null to return it to the unassigned queue. An agent of another product is reported as not found
+ */
+agentId: (string | null)
+}
+
+export interface SupportThreadAssignOutput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}
+
+export interface SupportThreadCreateInput {
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Short human-readable subject of the thread
+ */
+title: string
+/**
+ * Labels to put on the new thread
+ * 
+ * @maxItems 50
+ */
+labelIds?: string[]
+/**
+ * Free-form client-owned JSON attached to the thread
+ */
+metadata?: {
+[k: string]: unknown
+}
+/**
+ * Optional display name for the external author, as the client already knows it
+ */
+authorDisplay?: string
+/**
+ * Opaque identifier of the external end user in the client's own user base. Stored verbatim: never resolved, normalised or enriched, and it is not a Lessly identity
+ */
+authorExternalId: string
+}
+
+export interface SupportThreadCreateOutput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}
+
+export interface SupportThreadGetInput {
+/**
+ * Thread id
+ */
+id: string
+}
+
+export interface SupportThreadGetOutput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}
+
+export interface SupportThreadListInput {
+/**
+ * Only threads of this type
+ */
+type?: ("ticket" | "feedback")
+/**
+ * Page size, 1..100 (default 25)
+ */
+limit?: number
+/**
+ * Number of threads to skip
+ */
+offset?: number
+/**
+ * Only threads whose status belongs to this category. Resolved through a join on the status dictionary — the category is never stored on the thread
+ */
+category?: ("open" | "pending" | "resolved" | "closed")
+/**
+ * Only threads carrying ALL of these labels. Every other filter here narrows the result and so does this one: each additional label id makes the answer smaller, never bigger
+ */
+labelIds?: (string | string[])
+/**
+ * Only threads sitting on this exact status
+ */
+statusId?: string
+/**
+ * Only threads created at or before this ISO-8601 timestamp
+ */
+createdTo?: string
+/**
+ * Only threads created at or after this ISO-8601 timestamp
+ */
+createdFrom?: string
+/**
+ * Only threads assigned to this agent
+ */
+assignedAgentId?: string
+/**
+ * Only threads opened by this external author, matched verbatim
+ */
+authorExternalId?: string
+}
+
+export interface SupportThreadListOutput {
+/**
+ * Page size that was applied
+ */
+limit: number
+/**
+ * Offset that was applied
+ */
+offset: number
+/**
+ * The requested page of threads, newest first
+ */
+threads: {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}[]
+}
+
+export interface SupportThreadStatusSetInput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * Destination status of this product. Any status may follow any other — v1 has no transition rules. An archived status is refused
+ */
+statusId: string
+}
+
+export interface SupportThreadStatusSetOutput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}
+
+export interface SupportThreadUpdateInput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * New subject of the thread
+ */
+title?: string
+/**
+ * The complete new label set. Pass an empty array to remove every label
+ * 
+ * @maxItems 50
+ */
+labelIds?: string[]
+/**
+ * Replaces the whole client-owned metadata object
+ */
+metadata?: {
+[k: string]: unknown
+}
+/**
+ * New priority
+ */
+priority?: ("low" | "normal" | "high" | "urgent")
+}
+
+export interface SupportThreadUpdateOutput {
+/**
+ * Thread id
+ */
+id: string
+/**
+ * ticket: the end user wants something fixed. feedback: unsolicited input
+ */
+type: ("ticket" | "feedback")
+/**
+ * Thread subject
+ */
+title: string
+/**
+ * Every label on the thread, by name
+ */
+labels: {
+/**
+ * Label id
+ */
+id: string
+/**
+ * Label name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string, or null if uncoloured
+ */
+color: (string | null)
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+}[]
+/**
+ * The status itself, joined in at read time
+ */
+status: {
+/**
+ * Status id
+ */
+id: string
+/**
+ * Status name, unique within the product
+ */
+name: string
+/**
+ * Display colour as a hex string
+ */
+color: string
+/**
+ * Sort order within the status dictionary
+ */
+order: number
+/**
+ * Archived statuses stay readable but are not offered as targets
+ */
+archived: boolean
+/**
+ * Lifecycle bucket the status belongs to
+ */
+category: ("open" | "pending" | "resolved" | "closed")
+}
+/**
+ * Free-form client-owned JSON
+ */
+metadata: {
+[k: string]: unknown
+}
+/**
+ * Thread priority
+ */
+priority: ("low" | "normal" | "high" | "urgent")
+/**
+ * Id of the status the thread sits on
+ */
+statusId: string
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-modification timestamp
+ */
+updatedAt: string
+/**
+ * ISO-8601 timestamp of the last reply, or null while there are none
+ */
+lastReplyAt: (string | null)
+/**
+ * Display name for the external author, if given
+ */
+authorDisplay: (string | null)
+/**
+ * Assigned agent, or null while unassigned
+ */
+assignedAgentId: (string | null)
+/**
+ * The external author, byte-identical to what was stored
+ */
+authorExternalId: string
+}
+
 export interface TrackingDomainsCreateInput {
 host?: string
 records?: {