threads

Retrieve an agent thread

Retrieves details of a specific agent thread

get/v1/threads/{id}

Request

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

idstring required

Agent thread ID

agent thread found

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