Create an agent thread
Creates a new agent thread for running agent workflows
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
type
The agent type to use for this agent thread
business_id
Business to use as context for the thread. Shorthand for context_type=business. Required unless context_type and context_id are provided.
context_type
The type of context resource (e.g., “business”)
context_id
The ID of the context resource. Must be provided with context_type.
Response
agent thread created with context_type and context_id
object
Object type identifier.
id
Unique identifier for the agent thread.
created_at
Timestamp when the agent thread was created.
updated_at
Timestamp when the agent thread was last updated.
status
Current lifecycle status of the agent thread.
Allowed values:
metadata
Internal metadata associated with the agent thread.
requester
Requester context associated with the agent thread.
steps
Execution steps emitted by the underlying agent state
Errors
400
Create Agent Thread Request Bad Request Error
404
Create Agent Thread Request Not Found Error