---
title: "Create Ai Activate Index"
method: POST
path: "/ai_activate/indexes"
tags: ["AI Activate"]
---

# Create Ai Activate Index

`POST /ai_activate/indexes`

## Request

- Base URL: `https://am1.portal.api.nasuni.com`
- URL: `https://am1.portal.api.nasuni.com/ai_activate/indexes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nasuni/apis/portal-api/docs/ai_activate/indexes/post.ts> (a function with typed inputs; its response is checked against the schema)

Create AI Activate content index for a volume.

## Request body

- AiActivateCreateIndexRequestBodyDto
  - `volume_guid` string, required
  - `mcp_enabled` boolean, nullable
  - `include_paths` string[], nullable
  - `exclude_paths` string[], nullable

## Response `202`

AI Activate content indexing started

- AiActivateIndexConfigResponseDto: AI Activate index configuration returned by NOC. Reused across GET PATCH and POST
  - `volume_guid` string, required
  - `volume_name` string, required
  - `provider` string, required
  - `volume_region` string, nullable: Storage region of the volume. May be null when NOC has no volume metadata.
  - `status` 'in_progress' | 'complete' | 'failed' | 'queued_for_deletion', required
  - `file_count` integer, nullable: Number of files indexed for the volume. May be null until NOC reports a count.
  - `volume_size` string, nullable: Human-readable volume size string e.g. '10.5 TB'. May be unavailable until indexing progresses.
  - `mcp_enabled` boolean, nullable
  - `include_paths` string[]
  - `exclude_paths` string[]

## Other responses

- `400`: Bad request
- `401`: Not authenticated
- `403`: Insufficient permissions
- `404`: Resource not found
- `408`: Request timeout
- `409`: Resource state conflict
- `422`: Invalid input data
- `500`: Internal server error

---

[API](https://skmtc.dev/nasuni/apis/portal-api.md) - [All operations](https://skmtc.dev/nasuni/apis/portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nasuni/apis/portal-api/revisions/2a505bec6d14?raw)