Skip to main content
POST
/
agents
/
execute
Execute agent
curl --request POST \
  --url https://api.kaizenautomation.com/agents/execute \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>",
  "content": [
    {
      "type": "<string>",
      "text": "<string>"
    }
  ]
}
'
{
  "executionId": "<string>",
  "status": "<string>"
}

Body

application/json

Request parameters for executing an agent

​
agentId
string

External ID of the agent to execute. Optional when useAgentSkills is enabled for the organization - the backend will automatically use the most recently created agent.

​
content
object[]

Optional content array. If provided, this will be used as the initial message.

Response

Agent execution started successfully

Response after starting agent execution

​
executionId
string
required

ID of the execution

​
status
string
required

Current status of the execution