Execute Agent Operating Procedure | Athena

curl -X POST https://api.athenaintel.com/api/v0/aop/execute \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
  "run_budget": {
    "max_cost_usd": 30,
    "max_model_calls": 80
  },
  "user_inputs": {
    "company": "Acme Corp",
    "quarter": "Q1 2024"
  }
}'

{
  "aop_asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f",
  "aop_config": {
    "agentId": "research_agent"
  },
  "aop_title": "Market Research Report Generator",
  "base_prompt": "Generate a comprehensive market research report",
  "final_prompt": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n",
  "status": "completed",
  "sync_server": "https://iris.prd.athenaintel.com",
  "thread_id": "thread_12345-6789-abcd-efgh",
  "trigger_type": "api",
  "conversation": {
    "messages_source": "checkpoints",
    "num_messages": 3,
    "conversation_id": "asset_conversation_12345",
    "created_at": "2024-01-15T10:30:00Z",
    "last_assistant_message": {
      "content": [
        {
          "text": "I've completed the market research report for Acme Corp. Here are the key findings...",
          "type": "text"
        }
      ],
      "id": "msg_assistant_3",
      "role": "assistant",
      "additional_kwargs": {}
    },
    "messages": [
      {
        "content": [
          {
            "text": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n",
            "type": "text"
          }
        ],
        "id": "msg_user_1",
        "role": "user",
        "additional_kwargs": {}
      },
      {
        "content": "I'll help you create a comprehensive market research report for Acme Corp...",
        "id": "msg_assistant_2",
        "role": "assistant",
        "additional_kwargs": {}
      },
      {
        "content": "I've completed the market research report for Acme Corp. Here are the key findings...",
        "id": "msg_assistant_3",
        "role": "assistant",
        "additional_kwargs": {}
      }
    ],
    "title": "AOP Execution Conversation",
    "updated_at": "2024-01-15T10:45:00Z"
  }
}

DEPRECATED: This endpoint is deprecated. Please use /aop/execute-async instead for better performance and reliability. Execute an existing Agent Operating Procedure (AOP) asset with optional user inputs. AOPs are pre-configured AI workflows that can perform complex tasks like research, analysis, and content generation.

Authentication

X-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

asset_idstringRequired

ID of the existing AOP asset to execute

dry_runbooleanOptionalDefaults to false

Execute the AOP in dry-run mode: the agent runs with its real prompt, config, and read-only tools, but side-effectful tool calls (emails, external writes) are validated and captured instead of executed. The session remains visible and is marked with athena_metadata.is_dry_run for UI badging.

run_budgetobject or nullOptional

Optional spend cap for this execution: max_model_calls (top-level and sub-agent model calls) and/or max_cost_usd (provider cost at Athena’s model pricing). When a limit is reached the run stops before the next model call, ends with athena_termination_reason=run_budget, and the AOP execution settles as not succeeded. Absent = no cap beyond the agent’s step limit.

user_inputsmap from strings to strings or nullOptional

Optional user inputs to append to the AOP’s prompt as key-value pairs

Response

AOP execution started successfully

aop_asset_idstring

ID of the AOP asset that was executed

aop_configmap from strings to any

Full configuration of the AOP asset

aop_titlestring

Title of the AOP asset

base_promptstring

Base prompt of the AOP before user inputs were added

final_promptstring

Final prompt used for execution including user inputs

statusstring

Status of the execution (e.g., ‘submitted’)

sync_serverstring

Sync server URL used for execution

thread_idstring

Unique thread ID for tracking the execution

trigger_typestring

Type of trigger that initiated the execution

conversationobject or nullOptional

The conversation result from the AOP execution

errorstring or nullOptional

Error message if execution failed

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error