PAparcellab
Agents

Start async agent execution

Changed on

Starts agent execution asynchronously and returns a thread reference immediately. Use the thread reference to poll for results.

post/v4/agents/{agent_id}/execute/

Request

  • The document declares no server URL.
  • Auth
    • API key in header Authorization
    • or HTTP bearer

Path parameters

agent_idstring uuid required

External ID of this agent, used on the simple agent thread API

Request body

account_idinteger

Execution account ID. Required for installable agents.

querystring required

The user's input query

contextobject

Optional context data for the agent

Response

threadIdstring required

External reference ID of the thread

currentAgentstring uuid required

External ID of the agent currently responsible for the thread

executionStatusstring required

Current execution status

Changes