---
title: "Agent status"
method: GET
path: "/v0/agents/{id}"
---

# Agent status

`GET /v0/agents/{id}`

## Request

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

Retrieve the current status and results of a cloud agent

## Path parameters

- `id` string, required

## Response `200`

Agent details retrieved successfully

- object
  - `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

## Other responses

- `400`: Invalid request - bad agent ID format
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Agent not found or access denied
- `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)