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",
  "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://sync.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

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

asset_idstringRequired

ID of the existing AOP asset to execute

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 null

The conversation result from the AOP execution

errorstring or null

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