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

# 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-7', nullable — Optional model override (claude-haiku-4-5-20251001, claude-opus-4-7, claude-opus-4-7). 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

---

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