threads

Create an agent thread

Creates a new agent thread for running agent workflows

post/v1/threads

Request

Base URL
https://api.middesk.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/middesk/apis/middesk-api/docs/v1/threads/post.ts
A function with typed inputs. Its response is checked against the schema.

typestring required

The agent type to use for this agent thread

business_idstring uuid

Business to use as context for the thread. Shorthand for context_type=business. Required unless context_type and context_id are provided.

context_typestring

The type of context resource (e.g., "business")

context_idstring uuid

The ID of the context resource. Must be provided with context_type.

agent thread created with context_type and context_id

objectstring required

Object type identifier.

idstring uuid required

Unique identifier for the agent thread.

created_atstring date-time required

Timestamp when the agent thread was created.

updated_atstring date-time required

Timestamp when the agent thread was last updated.

agent_application_updated_atstring date-time nullable

Latest persisted Application update in this thread, or null before any exist.

status'running' | 'completed' | 'error' | 'interrupted' required

Current lifecycle status of the agent thread.

metadataobject nullable

Internal metadata associated with the agent thread.

requesterobject nullable

Requester context associated with the agent thread.

Oct 20, 2026a32370f9357e Revision changes
- info
  added the optional property to the response with the status
Sep 17, 20264c9cd4e834ba Revision changes
- warning
  deleted the header request parameter Authorization
- info
  the endpoint scheme security bearer_auth was added to the API