Skip to main content
POST
/
oracle
Oracle autonomous research agent (Pro only)
curl --request POST \
  --url https://apigcp.trynia.ai/v2/oracle \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "How does authentication work in the FastAPI codebase?",
  "repositories": [
    "fastapi/fastapi",
    "tiangolo/sqlmodel"
  ],
  "data_sources": [
    "FastAPI Documentation",
    "SQLModel Docs"
  ],
  "output_format": "markdown report with code examples"
}
'
{
  "success": true,
  "query": "<string>",
  "final_report": "<string>",
  "citations": [
    {
      "source": "<string>",
      "content": "<string>"
    }
  ],
  "tool_calls": [
    {
      "tool": "<string>",
      "args": {}
    }
  ],
  "iterations": 123,
  "duration_ms": 123,
  "session_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key must be provided in the Authorization header

Body

application/json
​
query
string
required

Research question to investigate

Example:

"How does authentication work in the FastAPI codebase?"

​
repositories
string[]

Optional list of repository identifiers to search

Example:
["fastapi/fastapi", "tiangolo/sqlmodel"]
​
data_sources
string[]

Optional list of documentation source identifiers to search

Example:
["FastAPI Documentation", "SQLModel Docs"]
​
output_format
string

Optional output format specification

Example:

"markdown report with code examples"

Response

Research completed successfully

​
success
boolean

Whether the research was successful

​
query
string

The research query that was executed

​
final_report
string

The comprehensive research report generated by Oracle

​
citations
object[]

List of sources cited in the research

​
tool_calls
object[]

List of tool calls made during research

​
iterations
integer

Number of research iterations performed

​
duration_ms
integer

Duration of the research in milliseconds

​
session_id
string

Unique session identifier for this research