Synvo API EndpointsQuery Layer

[POST] Get Context

Submit a query to the AI endpoint

Sends a message to the AI and receives a response. Supports streaming and various AI features (search, MCP, agent mode)

POST
/ai/query
X-API-Key<token>

In: header

payloadstring

JSON string with { messages: Message[] }

sub_user_name?string

Sub-user name for multi-user systems

Default"default"
final_answer?boolean

Request final answer from agent

Defaultfalse

Response Body

curl -X POST "https://api.synvo.ai/ai/query" \  -F payload="{\"messages\":[{\"role\":\"user\",\"content\":[{\"type\":\"text\",\"text\":\"Hello\"}]}]}"
{
  "success": true,
  "response": {
    "role": "system",
    "content": [
      {
        "type": "text",
        "text": "string",
        "path": "string",
        "file_id": "string"
      }
    ],
    "cuid": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "searched_files": [
      "string"
    ]
  },
  "suid": "string",
  "summary": "string",
  "timestamp": "2019-08-24T14:15:22Z"
}
Empty
Empty