---
title: "List agents"
method: GET
path: "/v0/agents"
---

# List agents

`GET /v0/agents`

## Request

- Base URL: `https://api.cursor.com`
- URL: `https://api.cursor.com/v0/agents`
- Auth: HTTP bearer

List all cloud agents for the authenticated user

## Query parameters

- `limit` integer
- `cursor` string
- `prUrl` string, uri

## Response `200`

Agents retrieved successfully

- object
  - `agents` object[], required: List of agents
    - `id` string, required: Unique identifier for the cloud agent
    - `name` string, required: Name for the agent
    - `status` 'RUNNING' | 'FINISHED' | 'ERROR' | 'CREATING' | 'EXPIRED', required: Current status of the cloud agent
    - `source` object, required
      - `repository` string: The GitHub repository URL
      - `ref` string: Git ref (branch or commit SHA) used as the base branch
    - `target` object, required
      - `branchName` string: The Git branch name where the agent is working
      - `url` string, required: URL to view the agent in Cursor Web
      - `prUrl` string: URL to view the pull request in GitHub, if any
      - `autoCreatePr` boolean: Whether a pull request will be automatically created
      - `openAsCursorGithubApp` boolean: Whether the pull request will be opened as the Cursor GitHub App
      - `skipReviewerRequest` boolean: Whether to skip adding the user as a reviewer to the pull request
    - `summary` string: Summary of the agent's work
    - `createdAt` string, date-time, required: When the agent was created
  - `nextCursor` string: Cursor for fetching the next page of results

## Other responses

- `400`: Invalid request - bad query parameters
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api.md) - [All operations](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/revisions/62c9131c7ea0?raw)