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

# Get Agent

> Returns one agent given an identifier.

### Permissions

Requires `Agents and workflows API` and `Use agents and workflows` permissions. If these permissions are not available to select, contact [support@harvey.ai](mailto:support@harvey.ai).


## OpenAPI

````yaml /agents_api.json get /api/v1/agents/{agent_id}
openapi: 3.0.1
info:
  title: Harvey Agents API
  description: >-
    Run Harvey text-based agents programmatically. Discover the agents available
    to your workspace, start an agent on a prompt with optional documents, then
    poll for the answer, its citations, and any files the agent produced.
  version: 1.0.0
  contact:
    email: support@harvey.ai
servers:
  - url: https://api.harvey.ai
    description: Harvey API server
security: []
paths:
  /api/v1/agents/{agent_id}:
    get:
      tags:
        - Agents
      summary: Get Agent
      description: Returns one agent given an identifier.
      operationId: getAgent
      parameters:
        - name: agent_id
          in: path
          required: true
          description: The unique identifier of the agent.
          schema:
            type: string
            format: uuid
          example: 01a0d9c9-3334-7036-ad4a-d14db13b93ba
      responses:
        '200':
          description: The requested agent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agent'
              examples:
                getAgent:
                  summary: Example response for a single agent
                  value:
                    agent_id: 01a0d9c9-3334-7036-ad4a-d14db13b93ba
                    name: Termination rights reviewer
                    description: Reviews an agreement and summarizes termination rights.
                    created_at: '2026-08-02T11:04:12Z'
                    version: 7
                    version_id: 9b1f2f41-6a0e-4f3b-9d0a-1c2b3d4e5f60
        '401':
          description: Unauthorized - Invalid or missing API token, or a missing permission
        '404':
          description: >-
            Not Found - No agent you can run has this id. Also returned for a
            malformed id, an unpublished agent, an agent whose knowledge sources
            you cannot access, and when the Agents API is not enabled for your
            workspace
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Agent not found
        '429':
          description: Too Many Requests - Rate limit exceeded
        '500':
          description: Internal Server Error
      security:
        - bearerAuth: []
components:
  schemas:
    Agent:
      type: object
      properties:
        agent_id:
          type: string
          format: uuid
          description: The unique identifier of the agent.
        name:
          type: string
          description: The agent's name.
        description:
          type: string
          nullable: true
          description: The agent's description. Null when its author did not give it one.
        created_at:
          type: string
          format: date-time
          description: When the agent was created.
        version:
          type: integer
          description: Version number of the agent's currently published version.
        version_id:
          type: string
          format: uuid
          description: >-
            Identifier of the agent's currently published version — the version
            a run started now would execute. Compare it against the value you
            last stored to detect that the agent was republished.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token

````

## Related topics

- [Get Agent Thread](/api-reference/agents/get-agent-thread.md)
- [Create Agent Thread](/api-reference/agents/create-agent-thread.md)
- [Rate Limits](/api-reference/ratelimits.md)


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