---
title: "Start Kb Consolidation Job"
method: POST
path: "/api/kb/{team_key}/jobs/consolidation"
tags: ["kb"]
---

# Start Kb Consolidation Job

`POST /api/kb/{team_key}/jobs/consolidation`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/kb/{team_key}/jobs/consolidation`
- Auth: HTTP bearer

Start a standalone KB consolidation job.

## Path parameters

- `team_key` string, required

## Request body

- StartKbConsolidationJobRequest: Request body for starting a standalone KB consolidation job.
  - `max_passes` integer

## Response `200`

Successful Response

- KbJobQueued: Queued job handle returned after creating a KB job row. Covers both curation and consolidation jobs — the handle is the same shape for either, so there is one type rather than one per job kind.
  - `jobKey` string, required
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required: Status of a job.

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)