---
title: "Create Oracle Job"
method: POST
path: "/oracle/jobs"
tags: ["Oracle"]
---

# Create Oracle Job

`POST /oracle/jobs`

## Request

- Base URL: `https://apigcp.trynia.ai/v2`
- URL: `https://apigcp.trynia.ai/v2/oracle/jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nozomio-labs/apis/nia-ai-api/docs/oracle/jobs/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new Oracle research job.

Returns immediately with job_id and session_id.
Use /oracle/jobs/{job_id}/stream to receive real-time updates.

Features:
- Per-user concurrency limit: max 3 concurrent Oracle jobs
- Job queuing: additional jobs wait in queue
- 30-minute timeout per job

## Request body

- OracleResearchRequest
  - `query` string, required: Research question to investigate
  - `repositories` string[], nullable: Optional list of repository identifiers
  - `data_sources` string[], nullable: Optional list of documentation source identifiers
  - `output_format` string, nullable: Optional output format specification
  - `model` string, nullable: Model to use: claude-opus-4-6, claude-opus-4-6-1m, claude-sonnet-4-5-20250929, or claude-sonnet-4-5-1m

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-28** `7e426dce5dda`: 2 info
  - api tag `Oracle` added
  - api tag `Usage` removed
- **2026-02-19** `c41dcb6ac8f7`: 2 info
  - api tag `Usage` added
  - api tag `Oracle` removed
- **2026-02-14** `5b3db391b9ea`: 1 info
  - api tag `Oracle` added

[Operation history](https://skmtc.dev/nozomio-labs/apis/nia-ai-api/changes/oracle/jobs/post.md)

---

[API](https://skmtc.dev/nozomio-labs/apis/nia-ai-api.md) - [All operations](https://skmtc.dev/nozomio-labs/apis/nia-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nozomio-labs/apis/nia-ai-api/revisions/dbb602a3ef17?raw)