Invoke

Beta

POST

https://api.athenaintel.com/api/v0/agents/general/invoke

POST

/api/v0/agents/general/invoke

curl -X POST https://api.athenaintel.com/api/v0/agents/general/invoke \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "config": {
    "enabled_tools": [
      "search"
    ]
  },
  "messages": [
    {
      "content": "Please call the search tool for AAPL news.",
      "role": "user"
    }
  ]
}'

{
  "messages": [
    {
      "type": "string",
      "additional_kwargs": {},
      "content": "string",
      "id": "string",
      "kwargs": {
        "type": "string",
        "additional_kwargs": {},
        "content": "string",
        "id": "string",
        "name": "string",
        "response_metadata": {},
        "role": "string",
        "tool_call_id": "string",
        "tool_calls": [
          {}
        ],
        "usage_metadata": {}
      },
      "langchain_id": [
        "string"
      ],
      "lc": 1,
      "message_id": "string",
      "name": "string",
      "response_metadata": {},
      "role": "string",
      "tool_call_id": "string",
      "tool_calls": [
        {}
      ],
      "usage_metadata": {}
    }
  ],
  "structured_output": {}
}

Call the general Athena agent synchronously. Call the agent with the messages list, wait for the agent to complete, and return the result.

Authentication

X-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

configobjectRequired

Configurable fields for the agent.

messageslist of objectsRequired

The messages to send to the agent. Each message should be a string (for text inputs) or a list of multimodal content parts.

channelstringOptionalDefaults to api

The channel through which the request is being made.

thread_idstring or nullOptional

Optional thread ID for conversation persistence. If not provided, a new thread will be created.

Response

Successful Response

messageslist of objects

structured_outputmap from strings to any or nullOptional

The agent's final answer as an object matching config.structured_output. Null when no schema was requested.

Errors

422

Unprocessable Entity Error

Authentication

Headers

Request

Response

Errors