CUcursor

List agents

List all cloud agents for the authenticated user

get/v0/agents

Request

  • Base URL
    https://api.cursor.com
  • Auth
    HTTP bearer

Query parameters

limitinteger

Number of cloud agents to return

cursorstring
Example:bc_xyz789

Pagination cursor from the previous response

prUrlstring uri
Example:https://github.com/your-org/your-repo/pull/123

Filter agents by pull request URL

Response

Agents retrieved successfully

nextCursorstring

Cursor for fetching the next page of results

Example response

{
  "agents": [
    {
      "id": "bc_abc123",
      "name": "Add README Documentation",
      "status": "RUNNING",
      "source": {
        "repository": "https://github.com/your-org/your-repo",
        "ref": "main"
      },
      "target": {
        "branchName": "cursor/add-readme-1234",
        "url": "https://cursor.com/agents?id=bc_abc123",
        "prUrl": "https://github.com/your-org/your-repo/pull/1234"
      },
      "summary": "Added README.md with installation instructions and usage examples",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "nextCursor": "bc_def456"
}

Changes

No recorded changes to this operation across all 1 revision of this API.