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

# Delete Agent

> Delete an AI voice agent.

Permanently removes the agent and detaches any phone numbers
assigned to it. Detached numbers remain active on your account
and can be reassigned to another agent.



## OpenAPI

````yaml /openapi.json delete /v1/agents/{agent_id}
openapi: 3.1.0
info:
  title: AgentLine
  description: >-
    AgentLine gives every AI agent a real phone number, a human-like voice, and
    the ability to make and receive calls and SMS autonomously. This SDK covers
    the core developer surface: agents, numbers, calls, messages, events,
    webhooks, billing, and voice.
  version: 0.3.0
  summary: Phone numbers, voice, and SMS for AI agents.
  contact:
    name: AgentLine
    url: https://agentline.cloud
  license:
    name: MIT
    url: https://opensource.org/license/mit
servers:
  - url: https://api.agentline.cloud
    description: Production
security:
  - API Key or OAuth: []
paths:
  /v1/agents/{agent_id}:
    delete:
      tags:
        - Agents
      summary: Delete Agent
      description: |-
        Delete an AI voice agent.

        Permanently removes the agent and detaches any phone numbers
        assigned to it. Detached numbers remain active on your account
        and can be reassigned to another agent.
      operationId: delete_agent
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - API Key or OAuth: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    API Key or OAuth:
      type: http
      description: >-
        AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp
        then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...
      scheme: bearer
      bearerFormat: API key (sk_live_...)
      x-fern-bearer:
        name: apiKey
        env: AGENTLINE_API_KEY

````