Skip to main content
POST
/
oracle
/
jobs
Create Oracle research job (Pro only)
curl --request POST \
  --url https://apigcp.trynia.ai/v2/oracle/jobs \
  --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",
  "model": "claude-opus-4-5-20251101"
}
'
{
  "job_id": "<string>",
  "session_id": "<string>",
  "status": "queued",
  "message": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

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"

​
model
enum<string>

Optional model selection for Oracle (defaults to claude-opus-4-5-20251101)

Available options:
claude-opus-4-5-20251101,
claude-sonnet-4-5-20250929,
claude-sonnet-4-5-1m

Response

Job created successfully

​
job_id
string

Unique job identifier

​
session_id
string

Research session identifier

​
status
enum<string>

Initial job status

Available options:
queued,
running
​
message
string

Status message

​
created_at
string<date-time>

When the job was created