POST
/
agent
/
{id}
/
execute
Execute an agent with structured parameters
curl --request POST \
  --url https://odyssey.asteroid.ai/api/v1/agent/{id}/execute \
  --header 'Content-Type: application/json' \
  --header 'X-Asteroid-Agents-Api-Key: <api-key>' \
  --data '{
  "agent_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "dynamic_data": {
    "name": "Alice",
    "email": "alice@example.com"
  }
}'
{
  "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
X-Asteroid-Agents-Api-Key
string
header
required

Path Parameters

​
id
string
required

The ID of the agent

Body

application/json

Request to execute an agent with structured parameters including optional agent profile configuration

Response

202
application/json

Agent execution started successfully

The response is of type object.