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

# Delete Conversation

> Delete a call and the personal data it holds. Irreversible. The recording and transcript are deleted; contexts (phone number, gathered answers), logs, SMS sent during the call and integration delivery records are erased, and every conversation endpoint returns 404 for it. Its duration and cost stay in the organization's usage records, which billing requires. Data already delivered elsewhere (webhooks, CRM, sheets) is not touched. 409 while the call is still in progress.



## OpenAPI

````yaml /api-reference/openapi.en.json delete /api/v1/agents/{agent_id}/conversations/{conversation_id}
openapi: 3.1.0
info:
  title: Brosbots API
  description: >
    The public Brosbots REST API. Build and manage voice agents, run outbound

    campaigns, read calls and usage, and manage phone numbers, tools,

    knowledge bases and integrations.


    ## Authentication


    Every request must include your organization's API key in the

    `X-API-Key` header:


    ```

    X-API-Key: bb_live_...

    ```


    You create and revoke keys in the dashboard:

    click your account in the bottom-left corner of the sidebar, then **Brosbots
    API**.


    ## Base URL


    ```

    https://app.brosbots.com/api/v1

    ```


    ## Conventions


    - Request and response bodies are JSON (`Content-Type: application/json`).

    - Timestamps are ISO 8601 with a timezone.

    - Lists are paginated with `page` / `limit` parameters; responses include
      `total_count` / `total_pages`.
    - Errors use standard HTTP status codes with a JSON body:
      `{"detail": "a human-readable reason"}`.
    - `{agent_id}` accepts the agent's public ID (`agent_...`) or its number.


    ## Limits


    There is no fixed per-key request-rate limit today. `429` comes from the

    calling endpoints (`POST /agents/{agent_id}/calls` and

    `POST /triggers/{trigger_id}/calls`) when every outbound channel is busy;
    its `Retry-After` header says how many seconds to wait. Handle `429`

    generally: wait as long as `Retry-After` says, or back off exponentially
    when

    it is absent. A request-rate limit may be introduced.
  version: 1.0.0
servers: []
security:
  - ApiKeyAuth: []
paths:
  /api/v1/agents/{agent_id}/conversations/{conversation_id}:
    delete:
      tags:
        - Agents & Calls
      summary: Delete Conversation
      description: >-
        Delete a call and the personal data it holds. Irreversible. The
        recording and transcript are deleted; contexts (phone number, gathered
        answers), logs, SMS sent during the call and integration delivery
        records are erased, and every conversation endpoint returns 404 for it.
        Its duration and cost stay in the organization's usage records, which
        billing requires. Data already delivered elsewhere (webhooks, CRM,
        sheets) is not touched. 409 while the call is still in progress.
      operationId: delete_agents_agent_id_conversations_conversation_id
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            anyOf:
              - type: string
                pattern: ^agent_[A-Za-z0-9]{20}$
              - type: integer
            examples:
              - agent_7fK2mQ9xLp3RtV8wYb1N
              - 42
          description: >-
            The agent's ID: the public `agent_` + 20 characters identifier shown
            in the dashboard (recommended), or the legacy number. Both address
            the same agent.
        - name: conversation_id
          in: path
          required: true
          schema:
            type: integer
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
        - name: X-API-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
      responses:
        '204':
          description: Successful Response
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your organization's API key (account in the bottom-left of the dashboard
        → Brosbots API).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.