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"
}
'
{
  "job_id": "<string>",
  "session_id": "<string>",
  "status": "queued",
  "message": "<string>",
  "stream_url": "<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

Job created successfully

​
job_id
string

Unique job identifier (Hatchet workflow run ID)

​
session_id
string

Research session identifier

​
status
enum<string>

Initial job status

Available options:
queued,
running
​
message
string

Status message

​
stream_url
string

URL to subscribe for real-time updates