> ## 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 from Index

> Remove an item from a search index

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

Remove a specific item (video or clip) from a search index. This permanently deletes the item and all associated clips from the index.

### Path Parameters

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

### Response

| Field          | Description                            |
| -------------- | -------------------------------------- |
| index\_id      | ID of the index                        |
| item\_id       | ID of the deleted item                 |
| clips\_removed | Number of clips removed from the index |
| message        | Confirmation message                   |

### Example Request

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

### Example Response

```json theme={null}
{
  "index_id": "idx_abc123xyz",
  "item_id": "item_def456",
  "clips_removed": 23,
  "message": "Item successfully deleted from index"
}
```

### Notes

* Deletion is permanent and cannot be undone
* All clips derived from the deleted item are also removed
* The item\_id is returned in search results and upload responses
* Deleting an item does not affect other items in the index


## OpenAPI

````yaml DELETE /api/v1/search/indexes/{index_id}/items/{item_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}/items/{item_id}:
    delete:
      tags:
        - Items
      summary: Delete from Index
      description: Remove a specific item (video or clip) from a search index.
      operationId: deleteFromIndex
      parameters:
        - name: index_id
          in: path
          required: true
          description: The ID of the index
          schema:
            type: string
        - name: item_id
          in: path
          required: true
          description: The ID of the item to delete
          schema:
            type: string
      responses:
        '200':
          description: Item deleted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteFromIndexResponse'
        '404':
          description: Index or item 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:
    DeleteFromIndexResponse:
      type: object
      properties:
        index_id:
          type: string
          description: ID of the index
          example: idx_abc123xyz
        item_id:
          type: string
          description: ID of the deleted item
          example: item_def456
        clips_removed:
          type: integer
          description: Number of clips removed from the index
          example: 23
        message:
          type: string
          description: Confirmation message
          example: Item successfully deleted from index
      required:
        - index_id
        - item_id
        - clips_removed
        - message
    Error:
      type: object
      properties:
        detail:
          type: string
          description: Error message
          example: Invalid request parameters

````