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

# Get Agent

> Get a specific agent by ID

<Endpoint method="GET" path="/v1/agents/{agentId}" description="Get a specific agent by ID">
  <RequestHeaders>
    <RequestHeader name="x-api-key" description="API key for authentication" required example="YOUR_API_KEY" />
  </RequestHeaders>

  <ResponseFields>
    <ResponseField status="200" description="Agent retrieved successfully" contentType="application/json" schemaRef="#/components/schemas/AgentResponse" />

    <ResponseField status="400" description="Unexpected error" contentType="application/json" schemaRef="#/components/schemas/Error" />
  </ResponseFields>
</Endpoint>


## OpenAPI

````yaml GET /v1/agents/{agentId}
openapi: 3.0.1
info:
  title: OpenAPI Example
  description: A sample API to demonstrate features in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.contactship.ai
security: []
paths:
  /v1/agents/{agentId}:
    get:
      description: Get a specific agent by ID
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
          description: API key for authentication
        - name: agentId
          in: path
          required: true
          schema:
            type: string
          description: The ID of the agent to retrieve
      responses:
        '200':
          description: Agent retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentResponse'
              example:
                statusCode: 200
                data:
                  id: 337a9eeb-3e16-4cc5-94ec-25fa159eb57a
                  name: Enterprise Sales Agent
                  person_name: James Wilson
                  language: en-US
                  webhook_url: https://webhook.example.com/enterprise-sales
                  conversation_purpose: Qualify enterprise leads and schedule product demonstrations
                  prompt: >-
                    You are James Wilson, an experienced enterprise sales
                    representative. Your goal is to understand potential
                    customers' business needs and demonstrate how our solutions
                    can help them scale. Focus on building rapport and
                    identifying key decision-makers.


                    Key points to remember:

                    - Ask about their current business challenges

                    - Explain our enterprise solutions clearly

                    - Highlight relevant case studies

                    - Schedule demos with qualified leads


                    Maintain a professional yet friendly tone, and always follow
                    up on specific industry requirements.
                  volume: 1.1
                  voice_id: custom_voice_james_enterprise
                  interruption_sensitivity: 0.85
                  ambient_sound: office
                  voice_speed: 0.95
                  voice_temperature: 0.7
                  post_call_analysis_data:
                    - name: company_size
                      type: string
                      description: Size category of the prospect company
                    - name: budget_range
                      type: string
                      description: Estimated budget range for the solution
                  tools:
                    - name: schedule_enterprise_demo
                      type: function
                      description: Schedule a product demonstration for enterprise clients
                    - name: access_case_studies
                      type: function
                      description: Retrieve relevant case studies by industry
                  created_at: '2024-01-15T10:30:00.000Z'
                  updated_at: '2024-03-20T15:45:00.000Z'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AgentResponse:
      type: object
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        data:
          $ref: '#/components/schemas/Agent'
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    Agent:
      type: object
      required:
        - id
        - name
        - created_at
        - language
      properties:
        id:
          type: string
          description: The ID of the agent
        name:
          type: string
          description: The name of the agent in our system
        person_name:
          type: string
          description: The name of the agent in the call
        language:
          type: string
          description: The language of the agent
        webhook_url:
          type: string
          nullable: true
          description: The webhook URL for call status updates
        conversation_purpose:
          type: string
          nullable: true
          description: The purpose of the conversation
        prompt:
          type: string
          nullable: true
          description: The prompt for the agent
        volume:
          type: number
          description: Volume level for the voice
        voice_id:
          type: string
          description: The ID of the voice to use
        interruption_sensitivity:
          type: number
          description: Sensitivity level for interruptions (0-1)
        ambient_sound:
          type: string
          nullable: true
          description: Background sound configuration
        voice_speed:
          type: number
          description: Speed of the voice
        voice_temperature:
          type: number
          description: Temperature parameter for voice generation
        post_call_analysis_data:
          type: array
          nullable: true
          description: Configuration for post-call analysis
          items:
            type: object
        tools:
          type: array
          nullable: true
          description: List of tools available to the agent
          items:
            type: object
        created_at:
          type: string
          format: date-time
          description: The creation time of the agent
        updated_at:
          type: string
          format: date-time
          description: The last update time of the agent

````