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

# Delete Memory Bucket

> Delete an existing memory bucket

## Headers

<ParamField header="X-API-Key" type="string" required>
  API authentication key (secret: xinobi)
</ParamField>

## Request Body

<ParamField body="bucket_id" type="string" required>
  Unique identifier of the bucket to delete
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the operation was successful
</ResponseField>

<ResponseField name="bucket_id" type="string">
  ID of the deleted bucket
</ResponseField>

<ResponseField name="deleted_at" type="string">
  ISO 8601 timestamp of deletion
</ResponseField>

<ResponseField name="message" type="string">
  Success message
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://memoryapi-production.up.railway.app/memory-bucket/delete" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: xinobi" \
    -d '{
      "bucket_id": "550e8400-e29b-41d4-a716-446655440000"
    }'
  ```

  ```json JSON Body theme={null}
  {
    "bucket_id": "550e8400-e29b-41d4-a716-446655440000"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "bucket_id": "550e8400-e29b-41d4-a716-446655440000",
    "deleted_at": "2024-01-01T00:00:00",
    "message": "Memory bucket 550e8400-e29b-41d4-a716-446655440000 deleted successfully (mock)"
  }
  ```
</ResponseExample>