Create an agent thread

Creates a new agent thread for running agent workflows

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

typestringRequired

The agent type to use for this agent thread

business_idstringOptionalformat: "uuid"

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

context_typestringOptional

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

context_idstringOptionalformat: "uuid"

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

agent thread created with context_type and context_id

objectstring

Object type identifier.

idstringformat: "uuid"

Unique identifier for the agent thread.

created_atdatetime

Timestamp when the agent thread was created.

updated_atdatetime

Timestamp when the agent thread was last updated.

statusenum

Current lifecycle status of the agent thread.

Allowed values:

metadatamap from strings to any or null

Internal metadata associated with the agent thread.

requestermap from strings to any or null

Requester context associated with the agent thread.

stepslist of objects or null

Execution steps emitted by the underlying agent state

1	import requests
2
3	url = "https://api.middesk.com/v1/threads"
4
5	payload = { "type": "cip_orchestrator" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())