@talqing/sdk 0.11.0 → 0.13.0

package/dist/esm/gen/types.gen.d.ts

@@ -182,7 +182,7 @@ export type AgentConfig = {
     /**
      * Greeting
      *
-     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{consent.notice}}`, the recording disclosure's place in the line.
+     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{recording.notice}}`, the recording notice's place in the line.
      */
     greeting?: string | null;
     /**
@@ -197,6 +197,12 @@ export type AgentConfig = {
      * Where this agent may hand the conversation next. Each entry becomes one tool the model can call, so routing quality lives in its `description`. A target is a stored agent (`agent_id`) or a member of the team defined on the call.
      */
     handoffs?: Array<HandoffTarget>;
+    /**
+     * Inbound Webhook
+     *
+     * Before an inbound call or channel chat starts, ask the workspace's inbound webhook for its vars, secrets, overrides, metadata and userdata. Refused if it does not answer.
+     */
+    inbound_webhook?: boolean;
     keypad_input?: KeypadInputSpec;
     /**
      * Language
@@ -318,7 +324,7 @@ export type AgentOverride = {
     /**
      * Greeting
      *
-     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{consent.notice}}`, the recording disclosure's place in the line.
+     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{recording.notice}}`, the recording notice's place in the line.
      */
     greeting?: string | null;
     /**
@@ -333,6 +339,12 @@ export type AgentOverride = {
      * Where this agent may hand the conversation next. Each entry becomes one tool the model can call, so routing quality lives in its `description`. A target is a stored agent (`agent_id`) or a member of the team defined on the call.
      */
     handoffs?: Array<HandoffTarget> | null;
+    /**
+     * Inbound Webhook
+     *
+     * Before an inbound call or channel chat starts, ask the workspace's inbound webhook for its vars, secrets, overrides, metadata and userdata. Refused if it does not answer.
+     */
+    inbound_webhook?: boolean | null;
     keypad_input?: KeypadInputSpecOverride | null;
     /**
      * Language
@@ -1169,6 +1181,19 @@ export type BuiltinToolSpec = {
      */
     type: string;
 };
+/**
+ * ButtonTap
+ */
+export type ButtonTap = {
+    /**
+     * Payload
+     */
+    payload?: string | null;
+    /**
+     * Text
+     */
+    text: string;
+};
 /**
  * CallBatchCounts
  */
@@ -1498,6 +1523,14 @@ export type CallSessionResponse = {
      * Livekit Room
      */
     livekit_room: string | null;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Phone Number Id
      */
@@ -1634,6 +1667,14 @@ export type CallSummaryResponse = {
      * Message Count
      */
     message_count?: number;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Outcome
      */
@@ -1891,6 +1932,14 @@ export type ChatResponse = {
      * Id
      */
     id: string;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Started At
      */
@@ -2140,10 +2189,24 @@ export type ConversationItemResponse = {
      * Attachments
      */
     attachments: Array<ConversationAttachment>;
+    /**
+     * Who at your business posted this.
+     */
+    author: ItemAuthor | null;
+    /**
+     * Channel
+     *
+     * How this item reached us or the person; null for notes and instructions.
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream' | 'copilot' | null;
     /**
      * Client Message Id
      */
     client_message_id: string | null;
+    /**
+     * What the person sent besides text; null for plain text.
+     */
+    content: InboundContent | null;
     /**
      * Conversation Id
      */
@@ -2156,7 +2219,7 @@ export type ConversationItemResponse = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Direction
      */
@@ -2169,6 +2232,16 @@ export type ConversationItemResponse = {
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Images Not Kept
+     *
+     * Images the person sent that were not stored, and why.
+     */
+    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -2181,6 +2254,12 @@ export type ConversationItemResponse = {
      * Origin
      */
     origin: 'speech' | 'typed' | 'keypad' | null;
+    /**
+     * Post Type
+     *
+     * What was posted through the API; null for everything else.
+     */
+    post_type: 'template' | 'agent_text' | 'note' | 'instruction' | null;
     /**
      * Provider Message Id
      */
@@ -2203,10 +2282,6 @@ export type ConversationItemResponse = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -2242,32 +2317,46 @@ export type ConversationItemResponse = {
  * The contact this conversation belongs to: key, binding, and what we know.
  */
 export type ConversationRefSummary = {
-    /**
-     * Bind Id
-     */
-    bind_id?: string | null;
     /**
      * Contact Key
      */
-    contact_key?: string | null;
+    contact_key: string;
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name: string | null;
     /**
      * Integration Id
      */
-    integration_id?: string | null;
+    integration_id: string | null;
     /**
      * Kind
      */
-    kind?: string | null;
+    kind: 'phone' | 'integration' | 'stream' | 'web';
     /**
      * Metadata
      */
-    metadata?: {
+    metadata: {
         [key: string]: unknown;
     };
+    /**
+     * Number
+     *
+     * Your number, on a phone contact.
+     */
+    number: string | null;
+    /**
+     * Peer
+     *
+     * Their number, on a phone contact.
+     */
+    peer: string | null;
+    /**
+     * Whatsapp Window Expires At
+     *
+     * When free-form WhatsApp messages stop being allowed; null if they never contacted you on WhatsApp.
+     */
+    whatsapp_window_expires_at: string | null;
 };
 /**
  * ConversationResponse
@@ -2395,6 +2484,14 @@ export type ConversationSessionResponse = {
      * Integration Id
      */
     integration_id: string | null;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     metrics: SessionMetrics;
     /**
      * Started At
@@ -2896,7 +2993,7 @@ export type CreateCallBatchRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -2907,7 +3004,8 @@ export type CreateCallBatchRequest = {
  *
  * Who the chat is with, what it starts knowing, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and is fixed for the life of the chat.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both are fixed for the life of the chat.
  */
 export type CreateChatRequest = {
     /**
@@ -2938,6 +3036,14 @@ export type CreateChatRequest = {
      * Contact Key
      */
     contact_key?: string | null;
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Userdata
      */
@@ -2947,7 +3053,7 @@ export type CreateChatRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -3069,7 +3175,7 @@ export type CreateEmailSendRequest = {
     /**
      * From Email
      */
-    from_email?: string | null;
+    from_email?: string;
     /**
      * From Name
      */
@@ -3091,7 +3197,7 @@ export type CreateEmailSendRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -3103,11 +3209,11 @@ export type CreateEmailSendRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -3115,7 +3221,7 @@ export type CreateEmailSendRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 /**
@@ -3272,6 +3378,96 @@ export type CreateStreamConnectionRequest = {
 export type CreateTaskRequest = {
     config: TaskConfig;
 };
+/**
+ * CreateTaskRunBatchRequest
+ */
+export type CreateTaskRunBatchRequest = {
+    /**
+     * Runs
+     */
+    runs: Array<RunItem>;
+    /**
+     * A complete task definition, run and stored nowhere else.
+     */
+    task?: TaskConfig | null;
+    /**
+     * Task Id
+     *
+     * A task in this workspace. Exclusive with `task`.
+     */
+    task_id?: string | null;
+    /**
+     * Changes for this run only: objects deep-merge, lists replace, null clears.
+     */
+    task_override?: TaskPatch | null;
+    /**
+     * Task Version
+     *
+     * Which version of `task_id` to run. Omit for the published one; `"draft"` runs the unpublished config, held to the publish checks.
+     */
+    task_version?: number | 'draft' | null;
+};
+/**
+ * CreateTaskRunRequest
+ */
+export type CreateTaskRunRequest = {
+    /**
+     * Background
+     *
+     * Queue the run and return at once (202) instead of waiting for its result.
+     */
+    background?: boolean;
+    /**
+     * Files
+     *
+     * One PDF per declared `file` input, by name.
+     */
+    files?: {
+        [key: string]: FileInput;
+    };
+    /**
+     * Idempotency Key
+     *
+     * Resending the same key returns the existing run instead of starting another.
+     */
+    idempotency_key?: string | null;
+    /**
+     * Metadata
+     *
+     * Up to 16 string labels of your own, for filtering.
+     */
+    metadata?: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * A complete task definition, run and stored nowhere else.
+     */
+    task?: TaskConfig | null;
+    /**
+     * Task Id
+     *
+     * A task in this workspace. Exclusive with `task`.
+     */
+    task_id?: string | null;
+    /**
+     * Changes for this run only: objects deep-merge, lists replace, null clears.
+     */
+    task_override?: TaskPatch | null;
+    /**
+     * Task Version
+     *
+     * Which version of `task_id` to run. Omit for the published one; `"draft"` runs the unpublished config, held to the publish checks.
+     */
+    task_version?: number | 'draft' | null;
+    /**
+     * Vars
+     *
+     * Values for the task's text inputs, by name. Undeclared names are refused.
+     */
+    vars?: {
+        [key: string]: string;
+    };
+};
 /**
  * CreateTelephonyAccountRequest
  */
@@ -3360,11 +3556,11 @@ export type CreateWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Integration Id
      *
@@ -3392,7 +3588,7 @@ export type CreateWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Template Id
      *
@@ -3402,7 +3598,7 @@ export type CreateWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     /**
      * To Column
      *
@@ -3498,6 +3694,14 @@ export type CreditLedgerEntryResponse = {
      * Balance After
      */
     balance_after: number;
+    /**
+     * Channel
+     */
+    channel: 'voice' | 'video' | 'text' | null;
+    /**
+     * Conversation Id
+     */
+    conversation_id: string | null;
     /**
      * Created At
      */
@@ -3553,14 +3757,47 @@ export type DeleteRecipientsRequest = {
      */
     recipient_ids: Array<string>;
 };
+/**
+ * DeleteTaskRunsRequest
+ */
+export type DeleteTaskRunsRequest = {
+    /**
+     * Metadata
+     *
+     * Runs whose metadata contains all of these pairs.
+     */
+    metadata: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * Task Id
+     */
+    task_id?: string | null;
+};
+/**
+ * DeleteTaskRunsResponse
+ */
+export type DeleteTaskRunsResponse = {
+    /**
+     * Count
+     */
+    count: number;
+};
 /**
  * DeliveryError
  *
  * Outbound delivery failure detail (provider HTTP / shadow-mode skips).
  *
- * Writers always store `{"message": ...}` (see services.messaging.delivery).
+ * Writers always store `{"message": ...}`, plus the provider's `code` when it
+ * gave one (see services.messaging.delivery).
  */
 export type DeliveryError = {
+    /**
+     * Code
+     *
+     * The provider's error code, if any.
+     */
+    code: string | null;
     /**
      * Message
      */
@@ -4197,9 +4434,15 @@ export type EndpointingSpecOverride = {
  * of individual `errors` (used wherever we surface many problems at once,
  * including tool publish, op-tree checks, and request validation). The global
  * exception handlers normalize every API error to
- * `{detail: {message, errors}}`, so SDKs can parse one shape consistently.
+ * `{detail: {message, errors, code}}`, so SDKs can parse one shape consistently.
  */
 export type ErrorBody = {
+    /**
+     * Code
+     *
+     * A stable identifier for this error, when it has one.
+     */
+    code?: string | null;
     /**
      * Errors
      */
@@ -4418,6 +4661,29 @@ export type FieldMap = {
      */
     to: string;
 };
+/**
+ * FileInput
+ *
+ * One PDF for a `file` input: a public https URL, or the bytes as a data URL.
+ */
+export type FileInput = {
+    /**
+     * Data Url
+     *
+     * `data:application/pdf;base64,<bytes>`, up to 20 MB decoded.
+     */
+    data_url?: string | null;
+    /**
+     * Filename
+     */
+    filename?: string | null;
+    /**
+     * Url
+     *
+     * An https URL the run downloads.
+     */
+    url?: string | null;
+};
 /**
  * FixedDailyCap
  *
@@ -4914,6 +5180,15 @@ export type IfOperation = {
      */
     then?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation> | null;
 };
+/**
+ * ImageNotKept
+ */
+export type ImageNotKept = {
+    /**
+     * Reason
+     */
+    reason: string;
+};
 /**
  * ImportPhoneNumbersRequest
  */
@@ -4972,6 +5247,24 @@ export type ImportedNumberResult = {
     ok: boolean;
     phone_number?: PhoneNumberResponse | null;
 };
+/**
+ * InboundContent
+ *
+ * What the person sent besides text.
+ */
+export type InboundContent = {
+    button: ButtonTap;
+    /**
+     * Kind
+     */
+    kind: 'button';
+    /**
+     * Replied To
+     *
+     * Provider id of the message this answers, e.g. the template.
+     */
+    replied_to?: string | null;
+};
 /**
  * InboundImage
  *
@@ -4987,6 +5280,35 @@ export type InboundImage = {
      */
     filename?: string | null;
 };
+/**
+ * InboundWebhookResponse
+ *
+ * The workspace's inbound session webhook.
+ */
+export type InboundWebhookResponse = {
+    /**
+     * Created At
+     */
+    created_at: string;
+    /**
+     * Secret
+     *
+     * The signing secret, only when it was just created or rotated.
+     */
+    secret: string | null;
+    /**
+     * Secret Hint
+     */
+    secret_hint: string;
+    /**
+     * Updated At
+     */
+    updated_at: string;
+    /**
+     * Url
+     */
+    url: string;
+};
 /**
  * InlineFaq
  *
@@ -5466,27 +5788,56 @@ export type InterruptionSpecOverride = {
     resume_false_interruption?: boolean | null;
 };
 /**
- * ItemCreatedEvent
+ * ItemAuthor
  *
- * One new item, in the same shape `list_conversation_items` returns it.
+ * Who at your business posted an item.
  */
-export type ItemCreatedEvent = {
+export type ItemAuthor = {
     /**
-     * Agent Id
+     * Id
      */
-    agent_id: string | null;
+    id: string;
     /**
-     * Agent Version
+     * Name
      */
-    agent_version: number | 'draft' | null;
-    /**
+    name: string;
+};
+/**
+ * ItemCreatedEvent
+ *
+ * One new item, in the same shape `list_conversation_items` returns it.
+ */
+export type ItemCreatedEvent = {
+    /**
+     * Agent Id
+     */
+    agent_id: string | null;
+    /**
+     * Agent Version
+     */
+    agent_version: number | 'draft' | null;
+    /**
      * Attachments
      */
     attachments: Array<ConversationAttachment>;
+    /**
+     * Who at your business posted this.
+     */
+    author: ItemAuthor | null;
+    /**
+     * Channel
+     *
+     * How this item reached us or the person; null for notes and instructions.
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream' | 'copilot' | null;
     /**
      * Client Message Id
      */
     client_message_id: string | null;
+    /**
+     * What the person sent besides text; null for plain text.
+     */
+    content: InboundContent | null;
     /**
      * Conversation Id
      */
@@ -5499,7 +5850,7 @@ export type ItemCreatedEvent = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Direction
      */
@@ -5516,6 +5867,16 @@ export type ItemCreatedEvent = {
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Images Not Kept
+     *
+     * Images the person sent that were not stored, and why.
+     */
+    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -5528,6 +5889,12 @@ export type ItemCreatedEvent = {
      * Origin
      */
     origin: 'speech' | 'typed' | 'keypad' | null;
+    /**
+     * Post Type
+     *
+     * What was posted through the API; null for everything else.
+     */
+    post_type: 'template' | 'agent_text' | 'note' | 'instruction' | null;
     /**
      * Provider Message Id
      */
@@ -5550,10 +5917,6 @@ export type ItemCreatedEvent = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -5586,13 +5949,13 @@ export type ItemCreatedEvent = {
 /**
  * ItemDeliveryUpdatedEvent
  *
- * An outbound item reached the provider, or failed to.
+ * An outbound item's delivery moved: claimed, sent, held, a receipt, or a failure.
  */
 export type ItemDeliveryUpdatedEvent = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Error
      */
@@ -6855,12 +7218,19 @@ export type OkResponse = {
      */
     ok?: boolean;
 };
+/**
+ * OpenerPolicy
+ */
+export type OpenerPolicy = {
+    opener: TemplateSend;
+};
 /**
  * OutboundCallRequest
  *
  * One phone call: who to dial, from which of your numbers, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and lasts exactly as long as this call.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both last exactly as long as this call.
  */
 export type OutboundCallRequest = {
     /**
@@ -6891,6 +7261,14 @@ export type OutboundCallRequest = {
      * From Phone Number Id
      */
     from_phone_number_id: string;
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * To
      */
@@ -6904,7 +7282,7 @@ export type OutboundCallRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -7439,9 +7817,9 @@ export type PageTaskResponse = {
     offset: number;
 };
 /**
- * Page[TaskRunResponse]
+ * Page[TaskRunSummary]
  */
-export type PageTaskRunResponse = {
+export type PageTaskRunSummary = {
     /**
      * Has More
      */
@@ -7449,7 +7827,7 @@ export type PageTaskRunResponse = {
     /**
      * Items
      */
-    items: Array<TaskRunResponse>;
+    items: Array<TaskRunSummary>;
     /**
      * Limit
      */
@@ -7601,7 +7979,7 @@ export type PatchCallBatchRequest = {
     /**
      * Agent Id
      */
-    agent_id?: string | null;
+    agent_id?: string;
     calling_window?: TimeWindow | null;
     /**
      * Dial Daily Cap
@@ -7614,27 +7992,27 @@ export type PatchCallBatchRequest = {
     /**
      * Dial Gap Seconds
      */
-    dial_gap_seconds?: number | null;
+    dial_gap_seconds?: number;
     /**
      * From Phone Number Id
      */
-    from_phone_number_id?: string | null;
+    from_phone_number_id?: string;
     /**
      * Max Attempts
      */
-    max_attempts?: number | null;
+    max_attempts?: number;
     /**
      * Max Concurrency
      */
-    max_concurrency?: number | null;
+    max_concurrency?: number;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Retry After Minutes
      */
-    retry_after_minutes?: number | null;
+    retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -7642,7 +8020,7 @@ export type PatchCallBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
 };
 /**
  * PatchConversationRequest
@@ -7653,7 +8031,7 @@ export type PatchConversationRequest = {
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Summary
      */
@@ -7663,7 +8041,7 @@ export type PatchConversationRequest = {
      */
     userdata?: {
         [key: string]: unknown;
-    } | null;
+    };
 };
 /**
  * PatchEmailBatchRequest
@@ -7684,28 +8062,31 @@ export type PatchEmailBatchRequest = {
     /**
      * Body Format
      */
-    body_format?: 'text' | 'html' | null;
+    body_format?: 'text' | 'html';
     /**
      * Draft Attempts
      */
-    draft_attempts?: number | null;
+    draft_attempts?: number;
     /**
      * Draft Concurrency
      */
-    draft_concurrency?: number | null;
+    draft_concurrency?: number;
     /**
      * Draft Gap Seconds
      */
-    draft_gap_seconds?: number | null;
+    draft_gap_seconds?: number;
     /**
      * Draft Retry After Minutes
      */
-    draft_retry_after_minutes?: number | null;
-    field_map?: FieldMap | null;
+    draft_retry_after_minutes?: number;
+    /**
+     * Field Map
+     */
+    field_map?: FieldMap;
     /**
      * From Email
      */
-    from_email?: string | null;
+    from_email?: string;
     /**
      * From Name
      */
@@ -7713,7 +8094,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Reply To
      */
@@ -7721,7 +8102,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -7733,11 +8114,11 @@ export type PatchEmailBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -7745,7 +8126,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 /**
@@ -7780,7 +8161,7 @@ export type PatchEmailSendRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -7792,11 +8173,11 @@ export type PatchEmailSendRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -7804,7 +8185,7 @@ export type PatchEmailSendRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 /**
@@ -7814,47 +8195,47 @@ export type PatchIntegrationRequest = {
     /**
      * Allowed Tools
      */
-    allowed_tools?: Array<string> | null;
+    allowed_tools?: Array<string>;
     /**
      * Credentials Ref
      */
-    credentials_ref?: string | null;
+    credentials_ref?: string;
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name?: string;
     /**
      * Mcp Config
      */
     mcp_config?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Metadata
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Provider Account Info
      */
     provider_account_info?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | 'needs_reconnect' | 'error' | null;
+    status?: 'active' | 'disabled' | 'needs_reconnect' | 'error';
     /**
      * Tools Namespace
      */
-    tools_namespace?: string | null;
+    tools_namespace?: string;
     /**
      * Webhook Config
      */
     webhook_config?: {
         [key: string]: unknown;
-    } | null;
+    };
 };
 /**
  * PatchIntegrationTriggerRequest
@@ -7867,13 +8248,13 @@ export type PatchIntegrationTriggerRequest = {
     /**
      * Enabled
      */
-    enabled?: boolean | null;
+    enabled?: boolean;
     /**
      * Metadata
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Provider Subscription Ref
      */
@@ -7881,15 +8262,15 @@ export type PatchIntegrationTriggerRequest = {
     /**
      * Reply Mode
      */
-    reply_mode?: 'public_reply' | 'internal_note' | 'none' | null;
+    reply_mode?: 'public_reply' | 'internal_note' | 'none';
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | 'needs_setup' | 'error' | null;
+    status?: 'active' | 'disabled' | 'needs_setup' | 'error';
     /**
      * Trigger Type
      */
-    trigger_type?: 'telegram.message.inbound' | 'whatsapp.message.inbound' | 'whatsapp.call.inbound' | null;
+    trigger_type?: 'telegram.message.inbound' | 'whatsapp.message.inbound' | 'whatsapp.call.inbound';
 };
 /**
  * PatchPhoneNumberRequest
@@ -7898,11 +8279,11 @@ export type PatchPhoneNumberRequest = {
     /**
      * Can Inbound
      */
-    can_inbound?: boolean | null;
+    can_inbound?: boolean;
     /**
      * Can Outbound
      */
-    can_outbound?: boolean | null;
+    can_outbound?: boolean;
     /**
      * Label
      */
@@ -7910,11 +8291,11 @@ export type PatchPhoneNumberRequest = {
     /**
      * Region
      */
-    region?: 'us' | 'in' | null;
+    region?: 'us' | 'in';
     /**
      * Status
      */
-    status?: 'disabled' | 'pending' | null;
+    status?: 'disabled' | 'pending';
 };
 /**
  * PatchStreamConnectionRequest
@@ -7923,19 +8304,19 @@ export type PatchStreamConnectionRequest = {
     /**
      * Agent Id
      */
-    agent_id?: string | null;
+    agent_id?: string;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Region
      */
-    region?: 'us' | 'in' | null;
+    region?: 'us' | 'in';
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | null;
+    status?: 'active' | 'disabled';
 };
 /**
  * PatchTaskRequest
@@ -7955,29 +8336,29 @@ export type PatchTelephonyAccountRequest = {
      */
     account_info?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Console Setup Confirmed
      */
-    console_setup_confirmed?: boolean | null;
+    console_setup_confirmed?: boolean;
     /**
      * Console Setup Region
      */
-    console_setup_region?: 'us' | 'in' | null;
+    console_setup_region?: 'us' | 'in';
     /**
      * Credentials
      */
     credentials?: {
         [key: string]: string;
-    } | null;
+    };
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name?: string;
     /**
      * Status
      */
-    status?: 'disabled' | 'connected' | null;
+    status?: 'disabled' | 'connected';
 };
 /**
  * PatchToolRequest
@@ -7986,33 +8367,33 @@ export type PatchToolRequest = {
     /**
      * Description
      */
-    description?: string | null;
+    description?: string;
     /**
      * Disable Interruptions
      */
-    disable_interruptions?: boolean | null;
+    disable_interruptions?: boolean;
     /**
      * Json Schema
      */
     json_schema?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Long Running Task
      */
-    long_running_task?: boolean | null;
+    long_running_task?: boolean;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Operations
      */
-    operations?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation> | null;
+    operations?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation>;
     /**
      * Silent
      */
-    silent?: boolean | null;
+    silent?: boolean;
 };
 /**
  * PatchWebhookRequest
@@ -8021,15 +8402,15 @@ export type PatchWebhookRequest = {
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | null;
+    status?: 'active' | 'disabled';
     /**
      * Subscribed Events
      */
-    subscribed_events?: Array<string> | null;
+    subscribed_events?: Array<string>;
     /**
      * Url
      */
-    url?: string | null;
+    url?: string;
 };
 /**
  * PatchWhatsAppBatchRequest
@@ -8042,15 +8423,15 @@ export type PatchWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Send Daily Cap
      *
@@ -8064,7 +8445,7 @@ export type PatchWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Start At
      */
@@ -8072,13 +8453,13 @@ export type PatchWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     /**
      * Variable Map
      */
     variable_map?: {
         [key: string]: string;
-    } | null;
+    };
     window?: TimeWindow | null;
 };
 /**
@@ -8204,6 +8585,76 @@ export type PlatformFeePerMinute = {
      */
     voice: number;
 };
+/**
+ * PostItemRequest
+ */
+export type PostItemRequest = {
+    /**
+     * Who at your business posted this; shown in transcripts, never sent to the person or shown to the agent.
+     */
+    author?: ItemAuthor | null;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key?: string | null;
+    /**
+     * On Window Closed
+     *
+     * fail refuses free text outside WhatsApp's 24h window; an opener sends that template and holds the message until they reply.
+     */
+    on_window_closed?: 'fail' | OpenerPolicy;
+    /**
+     * For `template` only.
+     */
+    template?: TemplateSend | null;
+    /**
+     * Text
+     *
+     * For the other three types.
+     */
+    text?: string | null;
+    /**
+     * The conversation, or your number and theirs to reach a person with no conversation yet.
+     */
+    to: PostTarget;
+    /**
+     * Type
+     *
+     * template and agent_text are delivered; note is never delivered; instruct has the agent write and send a message.
+     */
+    type: 'template' | 'agent_text' | 'note' | 'instruct';
+    /**
+     * Userdata
+     *
+     * Merged into the person's userdata and given to the agent that answers their reply.
+     */
+    userdata?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * PostTarget
+ *
+ * `conversation_id`, or `number` and `peer`.
+ */
+export type PostTarget = {
+    /**
+     * Conversation Id
+     */
+    conversation_id?: string | null;
+    /**
+     * Number
+     *
+     * Your business number, E.164.
+     */
+    number?: string | null;
+    /**
+     * Peer
+     *
+     * The person's number.
+     */
+    peer?: string | null;
+};
 /**
  * PreemptiveGenerationSpec
  *
@@ -8998,30 +9449,24 @@ export type RecordingResponse = {
 /**
  * RecordingSpec
  *
- * Whether calls with this agent are recorded, and what the caller is told.
+ * Whether calls with this agent are recorded, and whether the caller is told.
  *
  * On by default: one stereo file per call, kept until the workspace's
  * retention policy deletes it.
  */
 export type RecordingSpec = {
-    /**
-     * Consent
-     *
-     * Set to 'disclosure' to tell the caller the call is recorded. The greeting must then contain `{{consent.notice}}` to say where, and the agent gains a tool to stop recording if the caller objects.
-     */
-    consent?: 'off' | 'disclosure';
-    /**
-     * Consent Notice
-     *
-     * The sentence `{{consent.notice}}` resolves to in the greeting.
-     */
-    consent_notice?: string;
     /**
      * Enabled
      *
      * Record the call audio. Voice and video agents only.
      */
     enabled?: boolean;
+    /**
+     * Notice
+     *
+     * Spoken where the greeting places {{recording.notice}}, uninterruptibly. Null: no notice.
+     */
+    notice?: string | null;
 };
 /**
  * RecordingSpecOverride
@@ -9029,31 +9474,25 @@ export type RecordingSpec = {
  * A partial RecordingSpec: only the fields this call changes. Absent keeps the base value, an explicit null clears it, objects deep-merge and lists replace.
  */
 export type RecordingSpecOverride = {
-    /**
-     * Consent
-     *
-     * Set to 'disclosure' to tell the caller the call is recorded. The greeting must then contain `{{consent.notice}}` to say where, and the agent gains a tool to stop recording if the caller objects.
-     */
-    consent?: 'off' | 'disclosure' | null;
-    /**
-     * Consent Notice
-     *
-     * The sentence `{{consent.notice}}` resolves to in the greeting.
-     */
-    consent_notice?: string | null;
     /**
      * Enabled
      *
      * Record the call audio. Voice and video agents only.
      */
     enabled?: boolean | null;
+    /**
+     * Notice
+     *
+     * Spoken where the greeting places {{recording.notice}}, uninterruptibly. Null: no notice.
+     */
+    notice?: string | null;
 };
 /**
  * RecordingState
  *
  * What a reader should do about it. `available` is the only playable one.
  */
-export type RecordingState = 'none' | 'available' | 'pending' | 'expired' | 'failed' | 'not_shared' | 'consent_withdrawn' | 'deleted';
+export type RecordingState = 'none' | 'available' | 'pending' | 'expired' | 'failed' | 'not_shared' | 'deleted';
 /**
  * RedraftRequest
  *
@@ -9166,6 +9605,14 @@ export type ResumeCallRequest = {
      * Region
      */
     region?: 'us' | 'in';
+    /**
+     * Secrets
+     *
+     * Secrets to add or replace for the resumed call; the dropped call's are kept.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
 };
 /**
  * RoutedTTS
@@ -9194,6 +9641,43 @@ export type RoutedTTS = {
 export type Routes = {
     tts: RoutedTTS;
 };
+/**
+ * RunItem
+ *
+ * One run's inputs and labels.
+ */
+export type RunItem = {
+    /**
+     * Files
+     *
+     * One PDF per declared `file` input, by name.
+     */
+    files?: {
+        [key: string]: FileInput;
+    };
+    /**
+     * Idempotency Key
+     *
+     * Resending the same key returns the existing run instead of starting another.
+     */
+    idempotency_key?: string | null;
+    /**
+     * Metadata
+     *
+     * Up to 16 string labels of your own, for filtering.
+     */
+    metadata?: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * Vars
+     *
+     * Values for the task's text inputs, by name. Undeclared names are refused.
+     */
+    vars?: {
+        [key: string]: string;
+    };
+};
 /**
  * RunStepResponse
  *
@@ -9235,25 +9719,6 @@ export type RunStepResponse = {
      */
     status: string;
 };
-/**
- * RunTaskRequest
- */
-export type RunTaskRequest = {
-    /**
-     * Vars
-     *
-     * Values for the variables this task declares, by name. A `required` variable with no value and no default is refused before the run starts; a name the task does not declare is refused too, rather than silently dropped.
-     */
-    vars?: {
-        [key: string]: string;
-    };
-    /**
-     * Version
-     *
-     * Which definition to run. Omitted runs the published version. A number runs that frozen version. 'draft' runs the unpublished config, validated and tool-pinned at request time and refused with the publish errors if it does not hold together.
-     */
-    version?: number | 'draft' | null;
-};
 /**
  * RunToolRequest
  */
@@ -9264,6 +9729,14 @@ export type RunToolRequest = {
     arguments?: {
         [key: string]: unknown;
     };
+    /**
+     * Secrets
+     *
+     * Session secrets for this run; override workspace secrets of the same name.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Timezone
      *
@@ -9709,11 +10182,11 @@ export type SendWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Send Daily Cap
      *
@@ -9727,7 +10200,7 @@ export type SendWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Start At
      */
@@ -9735,7 +10208,7 @@ export type SendWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 /**
@@ -9847,6 +10320,17 @@ export type SessionUsage = {
      */
     tts: Array<TTSUsage>;
 };
+/**
+ * SetInboundWebhookRequest
+ */
+export type SetInboundWebhookRequest = {
+    /**
+     * Url
+     *
+     * An https URL on your server.
+     */
+    url: string;
+};
 /**
  * SetProviderKeyRequest
  */
@@ -10131,6 +10615,12 @@ export type StreamResponse = {
  * One `{{system_vars.*}}` variable the platform fills in.
  */
 export type SystemVarResponse = {
+    /**
+     * Channels
+     *
+     * The session channels this has a value on; empty means every one.
+     */
+    channels: Array<'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream'>;
     /**
      * Description
      */
@@ -10143,10 +10633,6 @@ export type SystemVarResponse = {
      * Key
      */
     key: string;
-    /**
-     * Voice Only
-     */
-    voice_only: boolean;
 };
 /**
  * TTSCatalogEntryResponse
@@ -10523,7 +11009,7 @@ export type TTSUsageResponse = {
  *
  * It declares no channel, no media and no greeting. Entered by an agent it
  * speaks with that call's voice and hears with its ears; run on its own from
- * `POST /tasks/{id}/run` it is an LLM with tools and nobody to talk to. Which
+ * `POST /task-runs` it is an LLM with tools and nobody to talk to. Which
  * of the two happens is the caller's, never the task's.
  */
 export type TaskConfig = {
@@ -10564,7 +11050,7 @@ export type TaskConfig = {
     /**
      * Output
      *
-     * The typed value this task produces. The model is given a `submit_result` tool built from these fields and told that calling it is how the run finishes. Publishing needs at least one; a draft may be empty.
+     * The typed value this task produces: up to 25 top-level fields, nesting up to 4 levels and 100 fields in all. The model finishes by calling a `submit_result` tool built from them. Publishing needs at least one.
      */
     output?: Array<TaskOutputField>;
     /**
@@ -10607,9 +11093,7 @@ export type TaskConfig = {
 /**
  * TaskOutputField
  *
- * One value the model must produce.
- *
- * Flat scalars only — no arrays and no nested objects.
+ * One value the model must produce: a scalar, an object of named fields, or an array.
  */
 export type TaskOutputField = {
     /**
@@ -10618,6 +11102,22 @@ export type TaskOutputField = {
      * What the model should put here, and what to send when it cannot find out. This is the field's description in the tool schema, so it is literally the prompt for this value.
      */
     description: string;
+    /**
+     * Enum
+     *
+     * Allowed values. Strings only.
+     */
+    enum?: Array<string> | null;
+    /**
+     * Fields
+     *
+     * An object's fields.
+     */
+    fields?: Array<TaskOutputField> | null;
+    /**
+     * An array's element.
+     */
+    items?: TaskOutputItem | null;
     /**
      * Name
      *
@@ -10633,9 +11133,42 @@ export type TaskOutputField = {
     /**
      * Type
      *
-     * The shape of the value. Anything that is not a number or a yes/no is a string.
+     * The shape of the value. `object` takes `fields`; `array` takes `items`.
      */
-    type?: 'string' | 'boolean' | 'integer' | 'number';
+    type?: 'string' | 'boolean' | 'integer' | 'number' | 'object' | 'array';
+};
+/**
+ * TaskOutputItem
+ *
+ * What an array holds: one element's shape. Unnamed, and never null.
+ */
+export type TaskOutputItem = {
+    /**
+     * Description
+     *
+     * What one element is.
+     */
+    description?: string;
+    /**
+     * Enum
+     *
+     * Allowed values. Strings only.
+     */
+    enum?: Array<string> | null;
+    /**
+     * Fields
+     *
+     * An object element's fields.
+     */
+    fields?: Array<TaskOutputField> | null;
+    /**
+     * A nested array's element.
+     */
+    items?: TaskOutputItem | null;
+    /**
+     * Type
+     */
+    type?: 'string' | 'boolean' | 'integer' | 'number' | 'object' | 'array';
 };
 /**
  * TaskPatch
@@ -10680,7 +11213,7 @@ export type TaskPatch = {
     /**
      * Output
      *
-     * The typed value this task produces. The model is given a `submit_result` tool built from these fields and told that calling it is how the run finishes. Publishing needs at least one; a draft may be empty.
+     * The typed value this task produces: up to 25 top-level fields, nesting up to 4 levels and 100 fields in all. The model finishes by calling a `submit_result` tool built from them. Publishing needs at least one.
      */
     output?: Array<TaskOutputField> | null;
     /**
@@ -10755,6 +11288,36 @@ export type TaskResponse = {
      */
     versions: Array<TaskVersionResponse> | null;
 };
+/**
+ * TaskRunBatchItem
+ */
+export type TaskRunBatchItem = {
+    /**
+     * Deduplicated
+     */
+    deduplicated: boolean;
+    /**
+     * Id
+     */
+    id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Status
+     */
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+};
+/**
+ * TaskRunBatchResponse
+ */
+export type TaskRunBatchResponse = {
+    /**
+     * Runs
+     */
+    runs: Array<TaskRunBatchItem>;
+};
 /**
  * TaskRunError
  */
@@ -10766,20 +11329,101 @@ export type TaskRunError = {
     /**
      * Type
      */
-    type: 'missing_vars' | 'no_output' | 'step_limit' | 'timeout' | 'provider_error' | 'configuration' | 'platform' | 'canceled';
+    type: 'invalid_input' | 'no_output' | 'step_limit' | 'timeout' | 'provider_error' | 'configuration' | 'platform' | 'canceled';
+};
+/**
+ * TaskRunFile
+ *
+ * What one PDF input turned into before the model read it.
+ */
+export type TaskRunFile = {
+    /**
+     * Bytes
+     */
+    bytes: number;
+    /**
+     * Filename
+     */
+    filename: string | null;
+    /**
+     * Images
+     */
+    images: Array<TaskRunImage>;
+    /**
+     * Input
+     */
+    input: string;
+    /**
+     * Pages
+     */
+    pages: number;
+    /**
+     * Text
+     */
+    text: string;
+};
+/**
+ * TaskRunImage
+ *
+ * A scanned page, as the model saw it.
+ */
+export type TaskRunImage = {
+    /**
+     * Height
+     */
+    height: number;
+    /**
+     * Page
+     */
+    page: number;
+    /**
+     * Url
+     */
+    url: string;
+    /**
+     * Url Expires At
+     */
+    url_expires_at: string;
+    /**
+     * Width
+     */
+    width: number;
 };
 /**
  * TaskRunResponse
+ *
+ * One run in full: the config it ran, its inputs, its trace and its usage.
  */
 export type TaskRunResponse = {
     /**
      * Attempts
      */
     attempts: number;
+    /**
+     * Background
+     */
+    background: boolean;
     /**
      * Billing Status
      */
     billing_status: string;
+    /**
+     * Cancel Requested At
+     */
+    cancel_requested_at: string | null;
+    config: TaskConfig | null;
+    /**
+     * Content Deleted At
+     */
+    content_deleted_at: string | null;
+    /**
+     * Content Expires At
+     */
+    content_expires_at: string | null;
+    /**
+     * Created At
+     */
+    created_at: string;
     /**
      * Duration Ms
      */
@@ -10789,14 +11433,28 @@ export type TaskRunResponse = {
      */
     ended_at: string | null;
     error: TaskRunError | null;
+    /**
+     * Files
+     */
+    files: Array<TaskRunFile>;
     /**
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
     /**
      * Max Steps
      */
     max_steps: number;
+    /**
+     * Metadata
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Output
      */
@@ -10810,11 +11468,11 @@ export type TaskRunResponse = {
     /**
      * Started At
      */
-    started_at: string;
+    started_at: string | null;
     /**
      * Status
      */
-    status: 'running' | 'completed' | 'failed';
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
     /**
      * Steps Used
      */
@@ -10835,6 +11493,10 @@ export type TaskRunResponse = {
      * Trace
      */
     trace: Array<TraceStepResponse>;
+    /**
+     * Tries
+     */
+    tries: number;
     /**
      * Usage
      */
@@ -10849,34 +11511,90 @@ export type TaskRunResponse = {
 /**
  * TaskRunSummary
  *
- * A run, as the list page shows it: what happened, when, and what it cost.
+ * A run without its trace, config or inputs: the list item, the
+ * `task_run.completed` webhook body and a task's `last_run`, one shape for all three.
  *
  * `error` is the same object a full run carries rather than a bare type, so
- * one reader answers "how did it go" for both — a summary that spelled the
- * same fact differently would be two shapes for one question.
+ * one reader answers "how did it go" for both.
  */
 export type TaskRunSummary = {
+    /**
+     * Background
+     */
+    background: boolean;
+    /**
+     * Billing Status
+     */
+    billing_status: string;
+    /**
+     * Content Deleted At
+     */
+    content_deleted_at: string | null;
+    /**
+     * Content Expires At
+     */
+    content_expires_at: string | null;
+    /**
+     * Created At
+     */
+    created_at: string;
     /**
      * Duration Ms
      */
-    duration_ms?: number | null;
-    error?: TaskRunError | null;
+    duration_ms: number | null;
+    /**
+     * Ended At
+     */
+    ended_at: string | null;
+    error: TaskRunError | null;
     /**
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Metadata
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Output
+     */
+    output: {
+        [key: string]: unknown;
+    } | null;
     /**
      * Provider Cost
      */
-    provider_cost?: number | null;
+    provider_cost: number | null;
     /**
      * Started At
      */
-    started_at: string;
+    started_at: string | null;
     /**
      * Status
      */
-    status: 'running' | 'completed' | 'failed';
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+    /**
+     * Task Id
+     */
+    task_id: string | null;
+    /**
+     * Task Name
+     */
+    task_name: string | null;
+    /**
+     * Task Version
+     */
+    task_version: number | null;
+    /**
+     * Tries
+     */
+    tries: number;
 };
 /**
  * TaskSelection
@@ -11187,6 +11905,81 @@ export type TelephonySetupStep = {
      */
     user_confirmable: boolean;
 };
+/**
+ * TemplateSend
+ */
+export type TemplateSend = {
+    /**
+     * Id
+     *
+     * Twilio Content SID (HX…) or Gupshup template id.
+     */
+    id: string;
+    /**
+     * Variables
+     *
+     * Every placeholder, button variables included.
+     */
+    variables?: {
+        [key: string]: string;
+    };
+};
+/**
+ * TestInboundWebhookRequest
+ */
+export type TestInboundWebhookRequest = {
+    /**
+     * Channel
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'telegram';
+    /**
+     * Number
+     *
+     * Your number, as `to`.
+     */
+    number: string;
+    /**
+     * Peer
+     *
+     * Theirs, as `from`.
+     */
+    peer: string;
+};
+/**
+ * TestInboundWebhookResponse
+ *
+ * What your server answered to a sample `session.request`.
+ */
+export type TestInboundWebhookResponse = {
+    /**
+     * Duration Ms
+     */
+    duration_ms: number;
+    /**
+     * Errors
+     */
+    errors: Array<string>;
+    /**
+     * Response
+     *
+     * The JSON object your server returned.
+     */
+    response: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Status Code
+     *
+     * Null when no HTTP response arrived.
+     */
+    status_code: number | null;
+    /**
+     * Valid
+     *
+     * Whether a real session would have accepted this answer.
+     */
+    valid: boolean;
+};
 /**
  * TimeWindow
  *
@@ -11224,7 +12017,8 @@ export type TimeWindow = {
  *
  * One browser call: who is on it, what it starts knowing, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and lasts exactly as long as this call.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both last exactly as long as this call.
  */
 export type TokenRequest = {
     /**
@@ -11259,6 +12053,14 @@ export type TokenRequest = {
      * Region
      */
     region?: 'us' | 'in';
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Userdata
      */
@@ -11268,7 +12070,7 @@ export type TokenRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -11772,11 +12574,11 @@ export type UpdateFaqEntryRequest = {
     /**
      * Answer
      */
-    answer?: string | null;
+    answer?: string;
     /**
      * Question
      */
-    question?: string | null;
+    question?: string;
 };
 /**
  * UpdateFaqRequest
@@ -11857,6 +12659,18 @@ export type VarDeclaration = {
      * Refuse the session rather than resolve this to nothing; a `default` satisfies it. An inbound phone call carries no request to supply values, so a voice agent requiring a variable with no default cannot be assigned to a phone number.
      */
     required?: boolean;
+    /**
+     * Type
+     *
+     * 'file' takes a PDF on a task run. Tasks only.
+     */
+    type?: 'text' | 'file';
+    /**
+     * Untrusted
+     *
+     * Third-party content: given to the model as data, never templated. Tasks only.
+     */
+    untrusted?: boolean;
 };
 /**
  * VerifiedSendersResponse
@@ -13248,6 +14062,12 @@ export type CallsListData = {
          * only calls placed by this outbound batch, retries included
          */
         batch_id?: string | null;
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
     };
     url: '/v1/calls';
 };
@@ -14610,6 +15430,12 @@ export type ChatsListData = {
          * Status
          */
         status?: 'open' | 'ended' | 'all';
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
     };
     url: '/v1/chats';
 };
@@ -15151,24 +15977,68 @@ export type ConversationsListResults = {
     200: PageConversationResponse;
 };
 export type ConversationsListResult = ConversationsListResults[keyof ConversationsListResults];
-export type ConversationsGetData = {
-    body?: never;
-    path: {
-        /**
-         * Conversation Id
-         */
-        conversation_id: string;
-    };
+export type ConversationsItemsCreateData = {
+    body: PostItemRequest;
+    path?: never;
     query?: never;
-    url: '/v1/conversations/{conversation_id}';
+    url: '/v1/conversations/items';
 };
-export type ConversationsGetErrors = {
+export type ConversationsItemsCreateErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
     401: ErrorResponse;
     /**
-     * No such resource in this organization.
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type ConversationsItemsCreateError = ConversationsItemsCreateErrors[keyof ConversationsItemsCreateErrors];
+export type ConversationsItemsCreateResults = {
+    /**
+     * Idempotent replay.
+     */
+    200: ConversationItemResponse;
+    /**
+     * Successful Response
+     */
+    201: ConversationItemResponse;
+};
+export type ConversationsItemsCreateResult = ConversationsItemsCreateResults[keyof ConversationsItemsCreateResults];
+export type ConversationsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Conversation Id
+         */
+        conversation_id: string;
+    };
+    query?: never;
+    url: '/v1/conversations/{conversation_id}';
+};
+export type ConversationsGetErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * No such resource in this organization.
      */
     404: ErrorResponse;
     /**
@@ -17122,6 +17992,182 @@ export type FaqsEntriesUpdateResults = {
     200: FaqEntry;
 };
 export type FaqsEntriesUpdateResult = FaqsEntriesUpdateResults[keyof FaqsEntriesUpdateResults];
+export type InboundWebhookDeleteData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookDeleteErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookDeleteError = InboundWebhookDeleteErrors[keyof InboundWebhookDeleteErrors];
+export type InboundWebhookDeleteResults = {
+    /**
+     * Successful Response
+     */
+    200: OkResponse;
+};
+export type InboundWebhookDeleteResult = InboundWebhookDeleteResults[keyof InboundWebhookDeleteResults];
+export type InboundWebhookGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookGetErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookGetError = InboundWebhookGetErrors[keyof InboundWebhookGetErrors];
+export type InboundWebhookGetResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookGetResult = InboundWebhookGetResults[keyof InboundWebhookGetResults];
+export type InboundWebhookSetData = {
+    body: SetInboundWebhookRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookSetErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookSetError = InboundWebhookSetErrors[keyof InboundWebhookSetErrors];
+export type InboundWebhookSetResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookSetResult = InboundWebhookSetResults[keyof InboundWebhookSetResults];
+export type InboundWebhookRotateSecretData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook/rotate-secret';
+};
+export type InboundWebhookRotateSecretErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookRotateSecretError = InboundWebhookRotateSecretErrors[keyof InboundWebhookRotateSecretErrors];
+export type InboundWebhookRotateSecretResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookRotateSecretResult = InboundWebhookRotateSecretResults[keyof InboundWebhookRotateSecretResults];
+export type InboundWebhookTestData = {
+    body: TestInboundWebhookRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook/test';
+};
+export type InboundWebhookTestErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookTestError = InboundWebhookTestErrors[keyof InboundWebhookTestErrors];
+export type InboundWebhookTestResults = {
+    /**
+     * Successful Response
+     */
+    200: TestInboundWebhookResponse;
+};
+export type InboundWebhookTestResult = InboundWebhookTestResults[keyof InboundWebhookTestResults];
 export type IntegrationsListData = {
     body?: never;
     path?: never;
@@ -18070,10 +19116,32 @@ export type TelephonyStreamsUpdateResults = {
     200: StreamConnectionResponse;
 };
 export type TelephonyStreamsUpdateResult = TelephonyStreamsUpdateResults[keyof TelephonyStreamsUpdateResults];
-export type TasksListData = {
+export type TaskRunsListData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Task Id
+         */
+        task_id?: string | null;
+        /**
+         * Status
+         */
+        status?: 'queued' | 'running' | 'completed' | 'failed' | 'canceled' | null;
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
+        /**
+         * Created After
+         */
+        created_after?: string | null;
+        /**
+         * Created Before
+         */
+        created_before?: string | null;
         /**
          * Limit
          */
@@ -18083,9 +19151,9 @@ export type TasksListData = {
          */
         offset?: number;
     };
-    url: '/v1/tasks';
+    url: '/v1/task-runs';
 };
-export type TasksListErrors = {
+export type TaskRunsListErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -18099,21 +19167,21 @@ export type TasksListErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksListError = TasksListErrors[keyof TasksListErrors];
-export type TasksListResults = {
+export type TaskRunsListError = TaskRunsListErrors[keyof TaskRunsListErrors];
+export type TaskRunsListResults = {
     /**
      * Successful Response
      */
-    200: PageTaskResponse;
+    200: PageTaskRunSummary;
 };
-export type TasksListResult = TasksListResults[keyof TasksListResults];
-export type TasksCreateData = {
-    body: CreateTaskRequest;
+export type TaskRunsListResult = TaskRunsListResults[keyof TaskRunsListResults];
+export type TaskRunsCreateData = {
+    body: CreateTaskRunRequest;
     path?: never;
     query?: never;
-    url: '/v1/tasks';
+    url: '/v1/task-runs';
 };
-export type TasksCreateErrors = {
+export type TaskRunsCreateErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -18139,26 +19207,110 @@ export type TasksCreateErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksCreateError = TasksCreateErrors[keyof TasksCreateErrors];
-export type TasksCreateResults = {
+export type TaskRunsCreateError = TaskRunsCreateErrors[keyof TaskRunsCreateErrors];
+export type TaskRunsCreateResults = {
     /**
      * Successful Response
      */
-    201: TaskResponse;
+    200: TaskRunResponse;
+    /**
+     * Queued (`background: true`).
+     */
+    202: TaskRunResponse;
 };
-export type TasksCreateResult = TasksCreateResults[keyof TasksCreateResults];
-export type TasksDeleteData = {
+export type TaskRunsCreateResult = TaskRunsCreateResults[keyof TaskRunsCreateResults];
+export type TaskRunsCreateBatchData = {
+    body: CreateTaskRunBatchRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/task-runs/batch';
+};
+export type TaskRunsCreateBatchErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type TaskRunsCreateBatchError = TaskRunsCreateBatchErrors[keyof TaskRunsCreateBatchErrors];
+export type TaskRunsCreateBatchResults = {
+    /**
+     * Successful Response
+     */
+    202: TaskRunBatchResponse;
+};
+export type TaskRunsCreateBatchResult = TaskRunsCreateBatchResults[keyof TaskRunsCreateBatchResults];
+export type TaskRunsDeleteManyData = {
+    body: DeleteTaskRunsRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/task-runs/delete';
+};
+export type TaskRunsDeleteManyErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type TaskRunsDeleteManyError = TaskRunsDeleteManyErrors[keyof TaskRunsDeleteManyErrors];
+export type TaskRunsDeleteManyResults = {
+    /**
+     * Successful Response
+     */
+    202: DeleteTaskRunsResponse;
+};
+export type TaskRunsDeleteManyResult = TaskRunsDeleteManyResults[keyof TaskRunsDeleteManyResults];
+export type TaskRunsDeleteData = {
     body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}';
 };
-export type TasksDeleteErrors = {
+export type TaskRunsDeleteErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -18188,26 +19340,25 @@ export type TasksDeleteErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksDeleteError = TasksDeleteErrors[keyof TasksDeleteErrors];
-export type TasksDeleteResults = {
+export type TaskRunsDeleteError = TaskRunsDeleteErrors[keyof TaskRunsDeleteErrors];
+export type TaskRunsDeleteResults = {
     /**
-     * Successful Response
+     * Deletion scheduled. No body.
      */
-    200: OkResponse;
+    202: unknown;
 };
-export type TasksDeleteResult = TasksDeleteResults[keyof TasksDeleteResults];
-export type TasksGetData = {
+export type TaskRunsGetData = {
     body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}';
 };
-export type TasksGetErrors = {
+export type TaskRunsGetErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -18225,26 +19376,26 @@ export type TasksGetErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksGetError = TasksGetErrors[keyof TasksGetErrors];
-export type TasksGetResults = {
+export type TaskRunsGetError = TaskRunsGetErrors[keyof TaskRunsGetErrors];
+export type TaskRunsGetResults = {
     /**
      * Successful Response
      */
-    200: TaskResponse;
+    200: TaskRunResponse;
 };
-export type TasksGetResult = TasksGetResults[keyof TasksGetResults];
-export type TasksUpdateData = {
-    body: PatchTaskRequest;
+export type TaskRunsGetResult = TaskRunsGetResults[keyof TaskRunsGetResults];
+export type TaskRunsCancelData = {
+    body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}/cancel';
 };
-export type TasksUpdateErrors = {
+export type TaskRunsCancelErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -18274,15 +19425,92 @@ export type TasksUpdateErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksUpdateError = TasksUpdateErrors[keyof TasksUpdateErrors];
-export type TasksUpdateResults = {
+export type TaskRunsCancelError = TaskRunsCancelErrors[keyof TaskRunsCancelErrors];
+export type TaskRunsCancelResults = {
     /**
      * Successful Response
      */
-    200: TaskResponse;
+    200: TaskRunResponse;
 };
-export type TasksUpdateResult = TasksUpdateResults[keyof TasksUpdateResults];
-export type TasksPublishData = {
+export type TaskRunsCancelResult = TaskRunsCancelResults[keyof TaskRunsCancelResults];
+export type TasksListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Limit
+         */
+        limit?: number;
+        /**
+         * Offset
+         */
+        offset?: number;
+    };
+    url: '/v1/tasks';
+};
+export type TasksListErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type TasksListError = TasksListErrors[keyof TasksListErrors];
+export type TasksListResults = {
+    /**
+     * Successful Response
+     */
+    200: PageTaskResponse;
+};
+export type TasksListResult = TasksListResults[keyof TasksListResults];
+export type TasksCreateData = {
+    body: CreateTaskRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/tasks';
+};
+export type TasksCreateErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type TasksCreateError = TasksCreateErrors[keyof TasksCreateErrors];
+export type TasksCreateResults = {
+    /**
+     * Successful Response
+     */
+    201: TaskResponse;
+};
+export type TasksCreateResult = TasksCreateResults[keyof TasksCreateResults];
+export type TasksDeleteData = {
     body?: never;
     path: {
         /**
@@ -18291,9 +19519,9 @@ export type TasksPublishData = {
         task_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/publish';
+    url: '/v1/tasks/{task_id}';
 };
-export type TasksPublishErrors = {
+export type TasksDeleteErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -18323,15 +19551,15 @@ export type TasksPublishErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksPublishError = TasksPublishErrors[keyof TasksPublishErrors];
-export type TasksPublishResults = {
+export type TasksDeleteError = TasksDeleteErrors[keyof TasksDeleteErrors];
+export type TasksDeleteResults = {
     /**
      * Successful Response
      */
-    200: PublishTaskResponse;
+    200: OkResponse;
 };
-export type TasksPublishResult = TasksPublishResults[keyof TasksPublishResults];
-export type TasksRunsListData = {
+export type TasksDeleteResult = TasksDeleteResults[keyof TasksDeleteResults];
+export type TasksGetData = {
     body?: never;
     path: {
         /**
@@ -18339,19 +19567,10 @@ export type TasksRunsListData = {
          */
         task_id: string;
     };
-    query?: {
-        /**
-         * Limit
-         */
-        limit?: number;
-        /**
-         * Offset
-         */
-        offset?: number;
-    };
-    url: '/v1/tasks/{task_id}/runs';
+    query?: never;
+    url: '/v1/tasks/{task_id}';
 };
-export type TasksRunsListErrors = {
+export type TasksGetErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -18369,16 +19588,16 @@ export type TasksRunsListErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksRunsListError = TasksRunsListErrors[keyof TasksRunsListErrors];
-export type TasksRunsListResults = {
+export type TasksGetError = TasksGetErrors[keyof TasksGetErrors];
+export type TasksGetResults = {
     /**
      * Successful Response
      */
-    200: PageTaskRunResponse;
+    200: TaskResponse;
 };
-export type TasksRunsListResult = TasksRunsListResults[keyof TasksRunsListResults];
-export type TasksRunsCreateData = {
-    body: RunTaskRequest;
+export type TasksGetResult = TasksGetResults[keyof TasksGetResults];
+export type TasksUpdateData = {
+    body: PatchTaskRequest;
     path: {
         /**
          * Task Id
@@ -18386,9 +19605,9 @@ export type TasksRunsCreateData = {
         task_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/runs';
+    url: '/v1/tasks/{task_id}';
 };
-export type TasksRunsCreateErrors = {
+export type TasksUpdateErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -18418,38 +19637,46 @@ export type TasksRunsCreateErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksRunsCreateError = TasksRunsCreateErrors[keyof TasksRunsCreateErrors];
-export type TasksRunsCreateResults = {
+export type TasksUpdateError = TasksUpdateErrors[keyof TasksUpdateErrors];
+export type TasksUpdateResults = {
     /**
      * Successful Response
      */
-    200: TaskRunResponse;
+    200: TaskResponse;
 };
-export type TasksRunsCreateResult = TasksRunsCreateResults[keyof TasksRunsCreateResults];
-export type TasksRunsGetData = {
+export type TasksUpdateResult = TasksUpdateResults[keyof TasksUpdateResults];
+export type TasksPublishData = {
     body?: never;
     path: {
         /**
          * Task Id
          */
         task_id: string;
-        /**
-         * Run Id
-         */
-        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/runs/{run_id}';
+    url: '/v1/tasks/{task_id}/publish';
 };
-export type TasksRunsGetErrors = {
+export type TasksPublishErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
     401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
     /**
      * No such resource in this organization.
      */
     404: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
     /**
      * The request did not match this operation's schema; `detail.errors` lists each field.
      */
@@ -18459,14 +19686,14 @@ export type TasksRunsGetErrors = {
      */
     default: ErrorResponse;
 };
-export type TasksRunsGetError = TasksRunsGetErrors[keyof TasksRunsGetErrors];
-export type TasksRunsGetResults = {
+export type TasksPublishError = TasksPublishErrors[keyof TasksPublishErrors];
+export type TasksPublishResults = {
     /**
      * Successful Response
      */
-    200: TaskRunResponse;
+    200: PublishTaskResponse;
 };
-export type TasksRunsGetResult = TasksRunsGetResults[keyof TasksRunsGetResults];
+export type TasksPublishResult = TasksPublishResults[keyof TasksPublishResults];
 export type TasksValidateData = {
     body?: never;
     path: {