---
title: "Index Project Files"
method: POST
path: "/api/projects/{project_id}/files/index"
tags: ["Project Files"]
---

# Index Project Files

`POST /api/projects/{project_id}/files/index`

## Request

- Base URL: `https://api.agentstack.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://api.agentstack.tech/api/projects/{project_id}/files/index`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Индексация файлов проекта.

🧬 Генетический код: ai_builder.endpoints.files.index.multi_level.gen2

Philosophy v0.1.24: Простой URL, параметры в query!

Returns:
{
    'success': true,
    'indexed_files': 45,
    'levels': ['skeleton', 'signatures', 'examples'],
    'duration_ms': 1234,
    'generation': 'gen2.2026-01-29T10:30:00Z'
}

## Path parameters

- `project_id` integer, required: Project ID

## Query parameters

- `levels` string[]: Index levels
- `force` boolean: Force reindex
- `incremental` boolean: Only index changed files

## Headers

- `Idempotency-Key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/agentstack/apis/agentstack-core-api.md) · [All operations](https://skmtc.dev/agentstack/apis/agentstack-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentstack/apis/agentstack-core-api/revisions/8ecf3406e74a?raw)