---
title: "Create Tracer Job"
method: POST
path: "/github/tracer"
tags: ["Tracer"]
---

# Create Tracer Job

`POST /github/tracer`

Create a Tracer search job.

Tracer is an autonomous agent that searches GitHub repositories
to answer your question. Returns immediately with a job_id and session_id.
Use /github/tracer/{job_id}/stream to receive real-time updates.

## Request body

- TracerRequest
  - `query` string, required — Research question
  - `repositories` string[], nullable — Repositories in owner/repo format
  - `context` string, nullable — Additional context
  - `model` 'claude-haiku-4-5-20251001' | 'claude-opus-4-6' | 'claude-opus-4-6-1m', nullable — Optional model override (claude-haiku-4-5-20251001, claude-opus-4-6, or claude-opus-4-6-1m). Must match mode when both are provided.
  - `mode` 'tracer-fast' | 'tracer-deep', nullable — Tracer mode: tracer-fast (Haiku) or tracer-deep (Opus). Defaults to tracer-deep. When mode and model are both provided, they must agree.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-02-28** `7e426dce5dda` — 1 breaking, 6 info
  - request property `model/anyOf[subschema #1]/` was restricted to a list of enum values
  - api tag `Tracer` added
  - api tag `GitHub Search` removed
  - added the new optional request property `mode`
  - …3 more
- **2026-02-19** `c41dcb6ac8f7` — 2 info
  - api tag `GitHub Search` added
  - api tag `GitHub & Tracer` removed
- **2026-02-14** `5b3db391b9ea` — 3 info
  - api tag `GitHub & Tracer` added
  - api tag `github-search` removed
  - api tag `v2-api` removed

[Change history](https://skmtc.dev/nozomio-labs/apis/nia-ai-api/changes/github/tracer/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-service-production.skmtc.workers.dev/v1/apis/nozomio-labs/nia-ai-api/revisions/dbb602a3ef17/schema)