Execute Agent Operating Procedure | Athena

1 curl -X POST https://api.athenaintel.com/api/v0/aop/execute \ 2 -H "X-API-KEY: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f", 6 "user_inputs": { 7 "company": "Acme Corp", 8 "quarter": "Q1 2024" 9 } 10 }'

1 { 2 "aop_asset_id": "asset_9249292-d118-42d3-95b4-00eccfe0754f", 3 "aop_config": { 4 "agentId": "research_agent" 5 }, 6 "aop_title": "Market Research Report Generator", 7 "base_prompt": "Generate a comprehensive market research report", 8 "final_prompt": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n", 9 "status": "completed", 10 "sync_server": "https://sync.athenaintel.com", 11 "thread_id": "thread_12345-6789-abcd-efgh", 12 "trigger_type": "api", 13 "conversation": { 14 "messages_source": "checkpoints", 15 "num_messages": 3, 16 "conversation_id": "asset_conversation_12345", 17 "created_at": "2024-01-15T10:30:00Z", 18 "last_assistant_message": { 19 "content": [ 20 { 21 "text": "I've completed the market research report for Acme Corp. Here are the key findings...", 22 "type": "text" 23 } 24 ], 25 "id": "msg_assistant_3", 26 "role": "assistant", 27 "additional_kwargs": {} 28 }, 29 "messages": [ 30 { 31 "content": [ 32 { 33 "text": "Generate a comprehensive market research report\n\n--- User Inputs ---\ncompany: Acme Corp\n", 34 "type": "text" 35 } 36 ], 37 "id": "msg_user_1", 38 "role": "user", 39 "additional_kwargs": {} 40 }, 41 { 42 "content": "I'll help you create a comprehensive market research report for Acme Corp...", 43 "id": "msg_assistant_2", 44 "role": "assistant", 45 "additional_kwargs": {} 46 }, 47 { 48 "content": "I've completed the market research report for Acme Corp. Here are the key findings...", 49 "id": "msg_assistant_3", 50 "role": "assistant", 51 "additional_kwargs": {} 52 } 53 ], 54 "title": "AOP Execution Conversation", 55 "updated_at": "2024-01-15T10:45:00Z" 56 } 57 }

⚠️ 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

Authentication

Request

Response

Errors