Cursor Cloud Agents

Add a follow-up instruction to an existing cloud agent while it's running. Use this to refine the agent's work, add additional requirements, or reques...

Retrieve audit log events for your team with filtering. Track team activity, security events, and configuration changes. Rate limited to 20 requests p...

Retrieve daily usage metrics for your team. Data is aggregated at the hourly level - we recommend polling this endpoint at most once per hour. Rate li...

Remove a specific repository from the blocklist. Returns 204 No Content on successful deletion.

Retrieve all repository blocklists configured for your team. Add repositories and use patterns to prevent files or directories from being indexed or u...

Set spending limits for individual team members. This allows you to control how much each user can spend on AI usage within your team. Rate limited to...

Retrieve spending information for the current calendar month with search, sorting, and pagination.

Retrieve all team members and their details including name, email, and role.

Replace existing repository blocklists for the provided repos. This endpoint will only overwrite the patterns for the repositories provided. All other...

Retrieve detailed usage events for your team with comprehensive filtering, search, and pagination options. Provides granular insights into individual ...

Retrieve granular accepted AI changes, grouped by deterministic changeId. Useful to analyze accepted AI events independent of commits. Returns changeI...

Download change metrics data in CSV format for large data extractions. Streams in pages of 10,000 records server-side. Returns CSV data with columns: ...

Retrieve aggregated per-commit metrics that attribute lines to TAB, COMPOSER, and non-AI. Returns commit hash, user info, repository/branch info, line...

Download commit metrics data in CSV format for large data extractions. Streams in pages of 10,000 records server-side. Returns CSV data with columns: ...

Get metrics on AI-suggested code edits accepted by your team in the Cursor IDE. Returns daily metrics including suggested/accepted/rejected diffs, lin...

Get agent edits metrics organized by individual users with pagination support. Returns data keyed by user email addresses, each containing an array of...

Get client versions metrics organized by individual users with pagination support. Returns data keyed by user email addresses, each containing an arra...

Get model usage metrics organized by individual users with pagination support. Returns data keyed by user email addresses, each containing an array of...

Get Tab usage metrics organized by individual users with pagination support. Returns data keyed by user email addresses, each containing an array of t...

Get top file extensions metrics organized by individual users with pagination support. Returns data keyed by user email addresses, each containing an ...

Get distribution of Cursor IDE client versions used by your team (defaults to last 7 days). Reports the latest version for each user per day.

Get daily active user counts for your team. DAU is the number of unique users who have used Cursor in a given day. Returns DAU breakdown metrics for t...

Get a leaderboard of team members ranked by AI usage metrics. Returns separate leaderboards for Tab autocomplete and Agent edits. Without user filteri...

Get metrics on AI model usage across your team. Returns daily breakdown of model usage including message counts and user counts per model.

Get metrics on Tab autocomplete usage across your team. Returns daily metrics including suggestions, accepts, rejects, and lines added/deleted via Tab...

Get the most frequently edited files across your team in the Cursor IDE. Returns the top 5 file extensions per day by suggestion volume.

Retrieve information about the API key being used for authentication. Returns the API key name, creation timestamp, and associated user email. Use thi...

Launch a new cloud agent to autonomously work on a GitHub repository. Provide a text prompt (and optional images) describing the task, specify the rep...

List all cloud agents for the authenticated user. Returns agent details including status (CREATING/RUNNING/FINISHED/FAILED/CANCELLED), repository info...

List recommended LLM models available for cloud agents. Returns model identifiers like 'claude-4-sonnet-thinking', 'o3', 'claude-4-opus-thinking'. Not...

List GitHub repositories accessible to the authenticated user. IMPORTANT: This endpoint has VERY STRICT rate limits - 1 request per minute per user, 3...

Permanently delete a cloud agent. This action cannot be undone. The agent's branch and code changes remain in the repository, but you lose access to t...

Fetch detailed information about a Cursor cloud agent or its conversation history. For agent details (cursor:agent:id): returns status, repository inf...