---
title: "Rebuild a derived surface (public verb)"
method: POST
path: "/v1/projections/{name}/rebuild"
tags: ["Projections"]
---

# Rebuild a derived surface (public verb)

`POST /v1/projections/{name}/rebuild`

## Request

- Base URL: `https://brain.inite.ai`
- URL: `https://brain.inite.ai/v1/projections/{name}/rebuild`
- Auth: HTTP bearer

The public verb over the maintenance batch engine. v1 rebuilds `facts` (the session-window deriver): derives into the given version (a paid, operator-invoked batch), optionally flips the live read pin (`activate`). Rewriting the pinned world needs `force`. 404 until PROJECTIONS_API_ENABLED=1.

Required scope: `brain:admin`.

## Path parameters

- `name` string, required

## Request body

- RebuildProjectionRequest
  - `activate` boolean
  - `conversation` string
  - `force` boolean
  - `keys` string[]
  - `version` string

## Response `200`

The batch result.

- RebuildProjectionResponse
  - `activated` boolean
  - `conversations` integer, required
  - `failed` integer, required
  - `outcome` BatchOutcome, required
    - `degradedBy` object[], required
      - `error` string, required
      - `key` string, required
    - `failed` object[], required
      - `error` string, required
      - `key` string, required
    - `status` 'complete' | 'degraded' | 'failed', required
    - `succeeded` integer, required
    - `total` integer, required
  - `previousVersion` string, nullable
  - `propositions` integer, required
  - `sessions` integer, required
  - `skipped` object[], required
    - `conversationId` string, required
    - `reason` string, required
  - `status` 'ok' | 'degraded' | 'failed', required
  - `unresolvedSubjects` integer, required

## Other responses

- `400`: Validation failed.
- `401`: Missing or unknown bearer key.
- `403`: The key lacks the required scope.
- `404`: No such resource in this tenant.

---

[API](https://skmtc.dev/inite/apis/inite-brain-platform-api.md) · [All operations](https://skmtc.dev/inite/apis/inite-brain-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inite/apis/inite-brain-platform-api/revisions/c7c3eb5e304b?raw)