# Cursor integration

> Cursor's APIs: launch and manage Cloud Agents, and administer a team (members, usage, spend, groups, model access), read analytics, AI code tracking and Bugbot.

- Authentication: apiKey

## Tools (129)

- **Add Members to Group**: Add team members to a billing group. Users must already be members of your team and not currently assigned to another group.
- **Add Team directory group members**: Add members to a manual Team directory group.
- **API Key Info**: Retrieve information about the API key being used for authentication.
- **Archive An Agent**: Archive an agent. Archived agents remain readable but cannot accept new runs until unarchived. Use this for reversible "soft delete" flows.
- **Cancel A Run**: Cancel the active run for an agent. Cancellation is terminal — the run transitions to `CANCELLED` and cannot be resumed.
- **Claim A Pending Request**: Reserve a pending pool request for a specific worker before that worker starts.
- **Create An Agent**: Create a Cloud Agent and immediately enqueue its initial run. The response returns both the durable `agent` and the initial `run`.
- **Create An Environment**: Create a saved environment. The response is `201` with the new environment.
- **Create A Run**: Send a follow-up prompt to an existing active agent. The new run uses the agent's current conversation and workspace state.
- **Create A Session Token**: Mint a session token for a claim your team already holds.
- **Create A User-Scoped Worker Token**: Create a one-hour user-scoped token for a worker to run as an active team member. Requires an agent-scoped team service account API key.
- **Create Grok Bot Team Rule**: Create a Grok Bot team rule. A team can store up to 50 Grok Bot rules. Returns **201**.
- **Create Group**: Create a new billing group. Rate limited to 20 requests per minute per team.
- **Create Team directory group**: Create a Team directory group with manually managed membership. To create a SCIM-synced group, sync it from your identity provider instead. See SCIM.
- **Delete An Agent Permanently**: Permanently delete an agent. This action is irreversible. Use Archive for reversible removal.
- **Delete An Environment**: Permanently delete a saved environment. This action is irreversible.
- **Delete An Environment Secret**: Delete one version of an environment secret. This action is irreversible. Every type can be deleted, Build Secrets included.
- **Delete A Team Secret**: Delete one version of a secret from the team your API key works in. This action is irreversible. Every type can be deleted, Build Secrets included.
- **Delete Grok Bot Setup Manifest**: Delete a setup manifest. Returns 204 No Content on success.
- **Delete Grok Bot Team Rule**: Delete a Grok Bot team rule. Returns 204 No Content on success.
- **Delete Group**: Delete a billing group. Returns 204 No Content on success. Rate limited to 20 requests per minute per team.
- **Delete Repo Blocklist**: Remove a specific repository from the blocklist. Returns 204 No Content on successful deletion.
- **Delete Team directory group**: Delete a Team directory group. The group must be empty: remove every member before deleting it.
- **Deregister A Pool**: Deregister (soft-delete) a durable pool so it no longer appears in pool pickers or List Pools. Workers currently connected to the pool are not affected.
- **Disable Grok Bot**: Disable Grok Bot for the team. Members lose access; their computers are not deleted. Returns **403** on Teams plans.
- **Download AI Code Change Metrics (CSV, streaming)**: Download change metrics data in CSV format for large data extractions.
- **Download AI Commit Metrics (CSV, streaming)**: Download commit metrics data in CSV format for large data extractions.
- **Download An Artifact**: Retrieve a temporary 15-minute presigned S3 URL for a specific artifact.
- **Enable Grok Bot**: Enable Grok Bot for the team. The first enable on an eligible Enterprise team starts the trial. Returns 204 No Content on success.
- **Fail A Claim**: Report that you can't start the worker you claimed for an agent, for example because your infrastructure is out of quota or is missing a permission.
- **Get Agent Edits**: Get metrics on AI-suggested code edits accepted by your team with Cursor.
- **Get Agent Edits By User**: Get agent edits metrics organized by individual users with pagination support.
- **Get Agent Usage**: Retrieve token usage for an agent, broken down per run. The response totals usage across every run on the agent and lists usage for each individual run.
- **Get AI Code Change Metrics (JSON, paginated)**: Retrieve granular accepted AI changes, grouped by deterministic changeId. Useful to analyze accepted AI events independent of commits.
- **Get AI Commit Metrics (JSON, paginated)**: Retrieve aggregated per-commit metrics that attribute lines to TAB, COMPOSER, and non-AI.
- **Get An Agent**: Retrieve durable metadata for an agent. Execution status lives on runs — fetch `latestRunId` and call Get A Run to read run state.
- **Get An Environment**: Retrieve a saved environment and its latest saved configuration.
- **Get An Environment Build**: Retrieve one of an environment's Builds. A build ID that isn't one of the environment's Builds returns `404 build_not_found`.
- **Get A Run**: Retrieve status, timestamps, and (for terminal runs) the final result, duration, and pushed branches for a specific run.
- **Get Ask Mode Adoption**: Get metrics on Ask mode adoption across your team. Returns daily adoption counts broken down by AI model used for Ask mode queries.
- **Get Ask Mode Adoption By User**: Get Ask mode adoption metrics organized by individual users with pagination support.
- **Get Audit Logs**: Retrieve audit log events for your team with filtering. Track team activity, security events, and configuration changes.
- **Get Bugbot Analytics**: Get per-PR Bugbot review analytics for your team, including issue counts by severity and how many issues were resolved.
- **Get Bugbot Review Analytics**: Return one item per completed Bugbot review, including the reviewed commit, findings count, billed cost, and per-finding resolution data.
- **Get Client Versions**: Get distribution of Cursor client versions used by your team (defaults to last 7 days).
- **Get Client Versions By User**: Get client version metrics organized by individual users with pagination support.
- **Get Commands Adoption**: Get metrics on Cursor command adoption across your team. Returns daily adoption counts broken down by command name.
- **Get Commands Adoption By User**: Get command adoption metrics organized by individual users with pagination support.
- **Get Commit Details**: Retrieve detailed information for one or more commits, including blame annotations and referenced conversation metadata.
- **Get Conversation Insights**: Get the same aggregate Conversation Insights data you see in the dashboard.
- **Get Daily Active Users (DAU)**: Get daily active user counts for your team. DAU is the number of unique users who have used Cursor in a given day.
- **Get Daily Usage Data**: Retrieve daily usage metrics for your team. Data is aggregated at the hourly level - we recommend polling this endpoint at most once per hour.
- **Get Enforce Auto-Review**: Return the team's Enforce Auto-Review policy.
- **Get Grok Bot Access**: Return who on the team can use Grok Bot.
- **Get Grok Bot Capabilities**: Return the team's Grok Bot capabilities.
- **Get Grok Bot Network Policy**: Return the team's Grok Bot network policy.
- **Get Group**: Retrieve a single billing group with its members and spend data for the current billing cycle.
- **Get Leaderboard**: Get a leaderboard of team members ranked by AI usage metrics.
- **Get MCP Adoption**: Get metrics on MCP (Model Context Protocol) tool adoption across your team. Returns daily adoption counts broken down by tool name and MCP server name.
- **Get MCP Adoption By User**: Get MCP tool adoption metrics organized by individual users with pagination support.
- **Get Model Access Configuration**: Return whether the team has a custom model-access policy and the defaults for newly seen providers and models.
- **Get Model Usage**: Get metrics on AI model usage across your team.
- **Get Model Usage By User**: Get model usage metrics organized by individual users with pagination support.
- **Get Plans Adoption**: Get metrics on Plan mode adoption across your team. Returns daily adoption counts broken down by AI model used for plan generation.
- **Get Plans Adoption By User**: Get Plan mode adoption metrics organized by individual users with pagination support.
- **Get Skills Adoption**: Get metrics on Skills adoption across your team. Returns daily adoption counts broken down by skill name.
- **Get Skills Adoption By User**: Get Skills adoption metrics organized by individual users with pagination support.
- **Get Spending Data**: Retrieve spending information for the current billing cycle with search, sorting, and pagination.
- **Get Tab Usage**: Get metrics on Tab autocomplete usage across your team.
- **Get Tab Usage By User**: Get Tab autocomplete metrics organized by individual users with pagination support.
- **Get Team directory group**: Retrieve one Team directory group.
- **Get Team Members**: Retrieve all team members and their details.
- **Get Team Repo Blocklists**: Retrieve all repository blocklists configured for your team. Add repositories and use patterns to prevent files or directories from being used as context.
- **Get The Active Build**: Find out what an agent you start on this environment boots from: one of its Builds, or Cursor's default image.
- **Get Top File Extensions**: Get the most frequently edited files across your team in Cursor. Returns the top 5 file extensions per day by suggestion volume.
- **Get Top File Extensions By User**: Get top file extension metrics organized by individual users with pagination support.
- **Get Usage Events Data**: Retrieve detailed usage events for your team with filtering, search, and pagination options.
- **Get Worker By ID**: Retrieve a single pool worker by its ID.
- **Get Worker Summary**: Return connected and in-use worker counts for the authenticated user and their team. Use this to trigger scaling decisions when utilization is high.
- **List Agents**: List agents for the authenticated user, newest first.
- **List Artifacts**: List artifacts produced by an agent. Each artifact's `path` is relative to the workspace's `artifacts/` directory.
- **List Bugbot Repositories**: List all repositories with their Bugbot settings for your team.
- **List Environment Builds**: List an environment's Builds, newest first, up to 10 per page.
- **List Environment History**: List the changes to an environment, newest first. These are the events its History tab in the Cloud Agents dashboard shows.
- **List Environments**: List the saved environments your API key can access, most recently updated first: your personal environments and your team's environments.
- **List Environment Secrets**: List an environment's Cloud Agents secrets. Each item is a secret version, and no item includes a value.
- **List GitHub Repositories**: List GitHub repositories accessible to the authenticated user through Cursor's GitHub App installation. This endpoint returns GitHub repositories only.
- **List Grok Bot Setup Manifests**: List Grok Bot setup manifests, ordered by `id`.
- **List Grok Bot Team Rules**: List Grok Bot team rules, newest first.
- **List Groups**: Retrieve all billing groups for your team with spend data for the current billing cycle.
- **List Model Access Providers**: List catalog providers and models with resolved enabled flags and per-model `parameters`. Returns **409** when the team does not have a custom policy.
- **List Models**: Returns the recommended models you can pass to the `model.id` field on Create An Agent, along with the parameters and variants each model accepts.
- **List Models for a Provider**: List models for one provider with resolved enabled flags and per-model `parameters`. The parameter fields match the providers response.
- **List Pending Pool Requests**: List pool requests that have not been assigned to a worker yet.
- **List Pools**: List durable pools for the authenticated service account's team.
- **List Runs**: List runs for an agent, newest first.
- **List Secrets**: List every Cloud Agents secret your API key can list in one paginated list.
- **List Team directory group members**: Retrieve members in a Team directory group.
- **List Team directory groups**: Retrieve Team directory groups for the team attached to your API key.
- **List Team Secrets**: List the Cloud Agents secrets of the team your API key works in. Each item is a secret version, and no item includes a value.
- **List Workers**: List pool workers for the authenticated service account's team, newest first.
- **Register A Pool**: Register a durable pool without starting a worker.
- **Release A Claim**: Release the claim that binds an agent to its self-hosted worker so the worker can serve another agent.
- **Remove Members from Group**: Remove team members from a billing group. Removed members are moved to the `Unassigned` group. Rate limited to 20 requests per minute per team.
- **Remove Team directory group members**: Remove members from a manual Team directory group.
- **Remove Team Member**: Remove a member from your team programmatically. This is useful for automating offboarding workflows or integrating with HR systems.
- **Replace Enforce Auto-Review**: Replace the team's Enforce Auto-Review policy. Returns **403** when Enforce Auto-Review is not available to the team.
- **Replace Grok Bot Network Policy**: Replace the team's Grok Bot network policy. Returns **403** on Teams plans.
- **Set An Environment Secret**: Create an environment secret, rotate its value, or change its type or repositories.
- **Set A Team Secret**: Create a secret for the team your API key works in, rotate its value, or change its type or repositories.
- **Set User Spend Limit**: Set spending limits for individual team members. This allows you to control how much each user can spend on AI usage within your team.
- **Set User Spend Limits in Bulk (Preview)**: Set spending limits for up to 100 team members in one request. Rate limited to 20 requests per minute per team. See rate limits.
- **Stream A Run**: Stream Server-Sent Events (SSE) for one run. The stream is scoped to the requested run and does not replay prior runs.
- **Trigger A Bugbot Review**: Queue a Bugbot review for a pull request or merge request. The request returns when the review is queued; the review runs asynchronously.
- **Unarchive An Agent**: Unarchive an agent so it can accept new runs again. Unarchive is idempotent — calling it on an already-active agent returns `200` with no change.
- **Update An Environment**: Rename an environment, replace its configuration, or both. A request with both fields applies them together, so either both change or neither does.
- **Update Bugbot Repository**: Enable or disable Bugbot for a repository.
- **Update Bugbot User Access**: Grant or revoke a source-control user access to the team Bugbot licenses.
- **Update Grok Bot Access**: Set who on the team can use Grok Bot. Returns **403** when group access is not available to the team.
- **Update Grok Bot Capabilities**: Update Grok Bot capabilities. Omitted fields stay unchanged. Returns **403** when a field is not available to the team. `enabled` is read-only.
- **Update Grok Bot Team Rule**: Update a Grok Bot team rule. Returns **404** when the rule does not exist. Send at least one field.
- **Update Group**: Update a billing group's name or directory group attachment. Rate limited to 20 requests per minute per team. Only one field can be updated per request.
- **Update Model Access Configuration**: Create a custom policy, update defaults, or return the team to unrestricted.
- **Update Model Access Model**: Enable or disable a single model, and optionally set per-model parameter restrictions and defaults.
- **Update Model Access Provider**: Enable or disable a provider. Returns **409** when the team is still `unrestricted` or `legacy`.
- **Update Team directory group**: Update a group's name or monthly spending limit. Updates are partial: include at least one field, and any field you omit keeps its current value.
- **Upsert Grok Bot Setup Manifest**: Create or replace a setup manifest. A team can store up to 100 manifests. Returns **409** when the manifest changed during the request.
- **Upsert Repo Blocklists**: Replace existing repository blocklists for the provided repos. This endpoint will only overwrite the patterns for the repositories provided.
- **Watch Pending Pool Requests**: Stream pending-request lifecycle events over Server-Sent Events (SSE) so controllers can react to queue changes without polling.

Connect Cursor in General Input: https://www.generalinput.com/apps/cursor