> ## 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.

# List Agents

> Lists the agents your workspace authored that you can run, most recently published first.

### 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
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:
    get:
      tags:
        - Agents
      summary: List Agents
      description: >-
        Lists the agents your workspace authored that you can run, most recently
        published first.
      operationId: listAgents
      parameters:
        - name: limit
          in: query
          description: >-
            Maximum number of agents to return per page. Values outside the
            accepted range are clamped rather than rejected.
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          example: 20
        - name: cursor
          in: query
          description: >-
            Opaque pagination cursor returned in the previous response's
            `pagination.next_cursor` field. Omit on the first request.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: A page of agents, newest publication first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentListResponse'
              examples:
                listAgents:
                  summary: Example response for listing agents
                  value:
                    agents:
                      - 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
                      - agent_id: 3e312cec-2841-4f87-8415-f625236ad02d
                        name: Vendor NDA triage
                        description: Flags deviations from the standard mutual NDA.
                        created_at: '2026-06-18T09:21:40Z'
                        version: 3
                        version_id: c7d4a1e2-5b86-4f09-a3cd-20e7b9f41d55
                    pagination:
                      limit: 20
                      has_more: true
                      next_cursor: eyJ2IjoxLCJsYXN0X2lkIjoiM2UzMTJjZWMtLi4uIn0=
        '400':
          description: Bad Request - The `cursor` could not be read
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid cursor.
        '401':
          description: Unauthorized - Invalid or missing API token, or a missing permission
        '404':
          description: Not Found - The Agents API is not enabled for your workspace
        '429':
          description: Too Many Requests - Rate limit exceeded
        '500':
          description: Internal Server Error
      security:
        - bearerAuth: []
components:
  schemas:
    AgentListResponse:
      type: object
      properties:
        agents:
          type: array
          description: The agents on this page.
          items:
            $ref: '#/components/schemas/Agent'
        pagination:
          $ref: '#/components/schemas/AgentListPagination'
    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.
    AgentListPagination:
      type: object
      description: Cursor pagination state for a page of agents.
      properties:
        limit:
          type: integer
          description: The page size actually applied, after clamping.
        has_more:
          type: boolean
          description: Whether more pages follow.
        next_cursor:
          type: string
          nullable: true
          description: Pass back as `cursor` for the next page. Null on the last page.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token

````

## Related topics

- [Audit Logs](/guides/audit_logs.md)
- [Rate Limits](/api-reference/ratelimits.md)
- [Agents](/guides/agents.md)


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