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

# Create Oracle Job

`POST /oracle/jobs`

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

---

[API](https://skmtc.net/nozomio-labs/apis/nia-ai-api.md) · [All operations](https://skmtc.net/nozomio-labs/apis/nia-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nozomio-labs/nia-ai-api/revisions/dbb602a3ef17/schema)