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": "[email protected]"
  }
}'
{
  "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

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

Path Parameters

​
id
string<uuid>
required

The ID of the agent

Body

application/json

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

​
agent_profile_id
string<uuid>

The ID of the browser profile to use

​
dynamic_data
object

Dynamic data to be merged into the saved agent configuration.

Example:
{
  "name": "Alice",
  "email": "[email protected]"
}

Response

Agent execution started successfully

​
execution_id
string<uuid>
required

The ID of the execution