> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Index

> Permanently delete a search index and all its contents

## DELETE /api/v1/search/indexes/{index_id}

Permanently delete a search index and all its contents. This removes the index, all uploaded items, and all indexed clips.

### Path Parameters

| Parameter | Type   | Required | Description                   |
| --------- | ------ | -------- | ----------------------------- |
| index\_id | string | Yes      | The ID of the index to delete |

### Response

| Field          | Description                             |
| -------------- | --------------------------------------- |
| index\_id      | ID of the deleted index                 |
| name           | Name of the deleted index               |
| items\_deleted | Number of items that were in the index  |
| clips\_deleted | Total number of clips that were deleted |
| message        | Confirmation message                    |

### Example Request

```bash theme={null}
curl -X DELETE https://api.usenarrative.ai/api/v1/search/indexes/idx_abc123xyz
```

### Example Response

```json theme={null}
{
  "index_id": "idx_abc123xyz",
  "name": "Sports Highlights Q4 2024",
  "items_deleted": 12,
  "clips_deleted": 347,
  "message": "Index successfully deleted"
}
```

### Notes

* This action is permanent and cannot be undone
* All items and clips in the index will be deleted
* Any URLs pointing to clips in this index will become invalid
* To remove a single item instead, use [Delete from Index](/api-reference/clipping/delete-from-index)


## OpenAPI

````yaml DELETE /api/v1/search/indexes/{index_id}
openapi: 3.0.3
info:
  title: Search API
  description: Video clip indexing and natural language search API
  version: 1.0.0
servers:
  - url: https://api.usenarrative.ai
    description: Production
security: []
paths:
  /api/v1/search/indexes/{index_id}:
    delete:
      tags:
        - Indexes
      summary: Delete Index
      description: Permanently delete a search index and all its contents.
      operationId: deleteIndex
      parameters:
        - name: index_id
          in: path
          required: true
          description: The ID of the index to delete
          schema:
            type: string
      responses:
        '200':
          description: Index deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteIndexResponse'
        '404':
          description: Index not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    DeleteIndexResponse:
      type: object
      properties:
        index_id:
          type: string
          description: ID of the deleted index
          example: idx_abc123xyz
        name:
          type: string
          description: Name of the deleted index
          example: Sports Highlights Q4 2024
        items_deleted:
          type: integer
          description: Number of items that were in the index
          example: 12
        clips_deleted:
          type: integer
          description: Total number of clips that were deleted
          example: 347
        message:
          type: string
          description: Confirmation message
          example: Index successfully deleted
      required:
        - index_id
        - name
        - items_deleted
        - clips_deleted
        - message
    Error:
      type: object
      properties:
        detail:
          type: string
          description: Error message
          example: Invalid request parameters

````