> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> How to set up the Cursor connector, plus the actions that are available.

![Cursor](https://stackone-logos.com/api/cursor/filled/svg)

Betav0.2.0[See changelog](https://docs.stackone.com/connectors/cursor/changelog.md)

[164 actions](#actions) · 4 auth methods

AI
Analytics
IAM
Developer Tools
Infrastructure
Security

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Admin API Key · Connector Profile](https://docs.stackone.com/connectors/cursor/guides/connector-profile/admin-api-key.md)
>
> Uses a team Admin API key for one Cursor team. Covers the Admin, Analytics, AI Code Tracking and Bugbot APIs; Analytics,...

> [card] [User API Key · Connector Profile](https://docs.stackone.com/connectors/cursor/guides/connector-profile/user-api-key.md)
>
> Uses a personal Cursor API key, so cloud agents run as that user with their GitHub connection and personal secrets. Cove...

> [card] [Service Account API Key · Connector Profile](https://docs.stackone.com/connectors/cursor/guides/connector-profile/service-account-api-key.md)
>
> Uses a Cursor team service account key, so cloud agents run without a person. Covers the Cloud Agents API, including sel...

> [card] [Organization API Key · Connector Profile](https://docs.stackone.com/connectors/cursor/guides/connector-profile/organization-api-key.md)
>
> Uses a Cursor Enterprise Organization API key for every team in the organization. Each key has one scope, which limits i...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Admin API Key · Link Account](https://docs.stackone.com/connectors/cursor/guides/link-account/admin-api-key.md)

> [card] [User API Key · Link Account](https://docs.stackone.com/connectors/cursor/guides/link-account/user-api-key.md)

> [card] [Service Account API Key · Link Account](https://docs.stackone.com/connectors/cursor/guides/link-account/service-account-api-key.md)

> [card] [Organization API Key · Link Account](https://docs.stackone.com/connectors/cursor/guides/link-account/organization-api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Admin API Key

Organization API Key

Service Account API Key

User API Key

No auth methods found

164 actions

ActionDescription

Get AI Commit Metrics`cursor_get_ai_commit_metrics`

List the Cursor team's git commits with how many lines came from Tab, Agent or were written by hand.

Download AI Commit Metrics`cursor_download_ai_commit_metrics`

Download the Cursor team's commit metrics for a date range as CSV.

Get AI Code Change Metrics`cursor_get_ai_code_change_metrics`

List accepted AI code changes (Tab completions and Agent edits) with the model and files touched.

Download AI Code Change Metrics`cursor_download_ai_code_change_metrics`

Download the Cursor team's accepted AI code changes for a date range as CSV.

Get Commit Details`cursor_get_commit_details`

Show which lines of one or more commits came from which AI conversation and model.

Get Agent Edits`cursor_agent_edits`

Get the Cursor team's daily Agent edit totals (diffs suggested, accepted and rejected, and lines added and removed).

Get Tab Usage`cursor_tab_usage`

Get the Cursor team's daily Tab completion totals (suggestions shown, accepted and rejected, and lines).

Get Daily Active Users (DAU)`cursor_daily_active_users_dau`

Get the Cursor team's daily active users, split by editor, CLI, cloud agents and Bugbot.

Get Client Versions`cursor_client_versions`

Get how many Cursor team members ran each Cursor client version per day.

Get Model Usage`cursor_model_usage`

Get the Cursor team's daily message and user counts per AI model.

Get Top File Extensions`cursor_top_file_extensions`

Get the five file extensions with the most Cursor suggestions each day.

Get MCP Adoption`cursor_mcp_adoption`

Get how often the Cursor team used each MCP server tool per day.

Get Commands Adoption`cursor_commands_adoption`

Get how often the Cursor team ran each command per day.

Get Plans Adoption`cursor_plans_adoption`

Get how often the Cursor team used Plan mode per model per day.

Get Skills Adoption`cursor_skills_adoption`

Get how often the Cursor team used each skill per day.

Get Ask Mode Adoption`cursor_ask_mode_adoption`

Get how often the Cursor team used Ask mode per model per day.

Get Conversation Insights`cursor_conversation_insights`

Get what the Cursor team's AI conversations were about (intents, complexity, categories, guidance levels and work types)...

Get Leaderboard`cursor_leaderboard`

Rank Cursor team members by accepted Tab completions and accepted Agent lines.

Get Bugbot Analytics`cursor_bugbot_analytics`

Get Bugbot review results per pull request (reviews run, issues found and issues resolved by severity).

Get Bugbot Review Analytics`cursor_bugbot_review_analytics`

List individual Bugbot reviews with the bugs found, cost and publication status.

Get Agent Edits By User`cursor_agent_edits_by_user`

Get daily Agent edit totals for each Cursor team member.

Get Tab Usage By User`cursor_tab_usage_by_user`

Get daily Tab completion totals for each Cursor team member.

Get Model Usage By User`cursor_model_usage_by_user`

Get daily message counts per AI model for each Cursor team member.

Get Top File Extensions By User`cursor_top_file_extensions_by_user`

Get each Cursor team member's top file extensions by suggestion volume per day.

Get Client Versions By User`cursor_client_versions_by_user`

Get the Cursor client version each team member ran per day.

Get MCP Adoption By User`cursor_mcp_adoption_by_user`

Get MCP tool usage per day for each Cursor team member.

Get Commands Adoption By User`cursor_commands_adoption_by_user`

Get command usage per day for each Cursor team member.

Get Plans Adoption By User`cursor_plans_adoption_by_user`

Get Plan mode usage per model per day for each Cursor team member.

Get Skills Adoption By User`cursor_skills_adoption_by_user`

Get skill usage per day for each Cursor team member.

Get Ask Mode Adoption By User`cursor_ask_mode_adoption_by_user`

Get Ask mode usage per model per day for each Cursor team member.

Get Audit Logs`cursor_get_audit_logs`

List the Cursor team's audit log events, such as sign-ins, member changes and settings changes.

List Groups`cursor_list_groups`

List the Cursor team's billing groups with members and spend for a billing cycle.

Get Group`cursor_get_group`

Get one Cursor billing group with its members and daily spend.

Create Group`cursor_create_group`

Create a billing group in the Cursor team to track spend for a set of members.

Update Group`cursor_update_group`

Rename a Cursor billing group or link it to a directory group.

Delete Group`cursor_delete_group`

Permanently delete a Cursor billing group.

Add Members To Group`cursor_add_members_to_group`

Add team members to a Cursor billing group.

Remove Members From Group`cursor_remove_members_from_group`

Remove members from a Cursor billing group.

Trigger A Review`cursor_trigger_a_review`

Queue a Bugbot review of a GitHub pull request or GitLab merge request, optionally as a dry run.

List Bugbot Repositories`cursor_listing_repositories`

List the repositories Bugbot knows for the team with whether each is enabled or manual-only.

Enable Or Disable Bugbot Repository`cursor_enabling_or_disabling_repositories`

Turn Bugbot on or off for a repository, or limit it to reviews that are triggered by hand.

Manage Bugbot User Access`cursor_managing_user_access`

Add or remove a GitHub, GitLab or Bitbucket user on the team's Bugbot allowlist or blocklist.

Create An Agent`cursor_create_an_agent`

Start a Cursor cloud agent on a prompt, optionally on one or more repositories, and get its first run.

List Agents`cursor_list_agents`

List Cursor cloud agents, newest first, optionally only those working on a pull request.

Get An Agent`cursor_get_an_agent`

Get one Cursor cloud agent with its status, repositories and latest run.

Send A Follow-Up Or Steer`cursor_send_a_follow_up_or_steer`

Give a Cursor cloud agent a follow-up prompt as a new run, or steer the run in progress.

List Runs`cursor_list_runs`

List the runs of one Cursor cloud agent.

Get A Run`cursor_get_a_run`

Get one run of a Cursor cloud agent, with its result and branches once it has finished.

Stream A Run`cursor_stream_a_run`

Read a Cursor cloud agent run's event stream of status, messages, tool calls and result.

Cancel A Run`cursor_cancel_a_run`

Stop a Cursor cloud agent run that is still in progress.

Get Agent Usage`cursor_get_agent_usage`

Get the tokens a Cursor cloud agent used, in total and per run.

List Artifacts`cursor_list_artifacts`

List the files a Cursor cloud agent saved as artifacts, such as screenshots and reports.

Download An Artifact`cursor_download_an_artifact`

Get a temporary download link for one of a Cursor cloud agent's artifacts.

Archive An Agent`cursor_archive_an_agent`

Archive a Cursor cloud agent so it no longer takes new runs. It can be unarchived later.

Unarchive An Agent`cursor_unarchive_an_agent`

Restore an archived Cursor cloud agent.

Delete An Agent Permanently`cursor_delete_an_agent_permanently`

Permanently delete a Cursor cloud agent and its runs.

List Environments`cursor_list_environments`

List the Cursor cloud agent environments the key can see, filtered by name, owner or repository.

Create An Environment`cursor_create_an_environment`

Create a named Cursor cloud agent environment for a set of repositories.

Get An Environment`cursor_get_an_environment`

Get one Cursor cloud agent environment with its definition and build settings.

Update An Environment`cursor_update_an_environment`

Rename a Cursor cloud agent environment, change its definition or repositories, or change its build settings.

Delete An Environment`cursor_delete_an_environment`

Permanently delete a Cursor cloud agent environment.

List Environment History`cursor_list_environment_history`

List the changes made to a Cursor cloud agent environment over time.

List Environment Builds`cursor_list_environment_builds`

List the snapshot builds of a Cursor cloud agent environment, filtered by status or date.

Start An Environment Build`cursor_start_an_environment_build`

Start a new snapshot build of a Cursor cloud agent environment.

Get An Environment Build`cursor_get_an_environment_build`

Get the status and result of one Cursor cloud agent environment build.

Get The Active Build`cursor_get_the_active_build`

Get which build new agents in a Cursor environment start from.

Get API Key Info`cursor_api_key_info`

Get the name and owner of the Cursor API key in use.

List Models`cursor_list_models`

List the models a Cursor cloud agent can run on, with their parameters.

List GitHub Repositories`cursor_list_github_repositories`

List the GitHub repositories the key owner's GitHub connection can reach, for use in create\_an\_agent.

Create A User-Scoped Worker Token`cursor_create_a_user_scoped_worker_token`

Get a one-hour token that lets a service account act as a team member on the Cloud Agents API.

List Secrets`cursor_list_secrets`

List the names and scopes of the Cursor cloud agent secrets the key can see, without their values.

List Environment Secrets`cursor_list_environment_secrets`

List the secrets of one Cursor cloud agent environment, without their values.

Set An Environment Secret`cursor_set_an_environment_secret`

Create or change a secret that agents in one Cursor cloud environment can read.

Delete An Environment Secret`cursor_delete_an_environment_secret`

Delete a secret from a Cursor cloud agent environment.

List Team Secrets`cursor_list_team_secrets`

List the team-wide Cursor cloud agent secrets, without their values.

Set A Team Secret`cursor_set_a_team_secret`

Create or change a secret that every agent on the Cursor team can read.

Delete A Team Secret`cursor_delete_a_team_secret`

Delete a team-wide Cursor cloud agent secret.

Set A Personal Secret`cursor_set_a_personal_secret`

Create or change a secret that only the key owner's Cursor cloud agents can read.

Delete A Personal Secret`cursor_delete_a_personal_secret`

Delete one of the key owner's personal Cursor cloud agent secrets.

List Workers`cursor_list_workers`

List the self-hosted Cursor cloud agent workers that are connected, and whether each is busy.

Get Worker Summary`cursor_get_worker_summary`

Get how many self-hosted Cursor workers are connected and how many are busy, for the key owner and the team.

Get Worker By ID`cursor_get_worker_by_id`

Get one self-hosted Cursor worker by its ID.

List Pools`cursor_list_pools`

List the self-hosted worker pools that Cursor cloud agents can run on.

Register A Pool`cursor_register_a_pool`

Register a self-hosted worker pool, optionally tied to one repository.

Deregister A Pool`cursor_deregister_a_pool`

Remove a self-hosted worker pool registration.

List Pending Pool Requests`cursor_list_pending_pool_requests`

List agent requests waiting for a self-hosted worker to claim them.

Claim A Pending Request`cursor_claim_a_pending_request`

Assign a pending agent request to a self-hosted worker.

Create A Session Token`cursor_create_a_session_token`

Get a session token for a request a self-hosted worker has already claimed.

Release A Claim`cursor_release_a_claim`

Free a self-hosted worker from a request it claimed.

Fail A Claim`cursor_fail_a_claim`

Report that a self-hosted worker could not run a request it claimed.

List Team Directory Groups`cursor_list_team_directory_groups`

List the Cursor team's directory groups with their member counts and spend limits.

Get Team Directory Group`cursor_get_team_directory_group`

Get one of the Cursor team's directory groups by ID.

List Team Directory Group Members`cursor_list_team_directory_group_members`

List the members of one Cursor directory group.

Create Team Directory Group`cursor_create_team_directory_group`

Create a directory group with manually managed membership in the Cursor team.

Update Team Directory Group`cursor_update_team_directory_group`

Rename a Cursor directory group or change its monthly spending limit.

Delete Team Directory Group`cursor_delete_team_directory_group`

Delete an empty Cursor directory group.

Add Team Directory Group Members`cursor_add_team_directory_group_members`

Add members to a manually managed Cursor directory group.

Remove Team Directory Group Members`cursor_remove_team_directory_group_members`

Remove members from a manually managed Cursor directory group.

Enable Grok Bot`cursor_enable_grok_bot`

Turn on Grok Bot for the Cursor team.

Disable Grok Bot`cursor_disable_grok_bot`

Turn off Grok Bot for the Cursor team.

Get Grok Bot Capabilities`cursor_get_grok_bot_capabilities`

Get whether Grok Bot is on and which of its capabilities the team allows.

Update Grok Bot Capabilities`cursor_update_grok_bot_capabilities`

Change which Grok Bot capabilities the team allows, such as cloud agents, template sharing or local execution.

Get Enforce Auto-Review`cursor_get_enforce_auto_review`

Get whether Grok Bot auto-review is enforced and its allow and block instructions.

Replace Enforce Auto-Review`cursor_replace_enforce_auto_review`

Replace the Grok Bot auto-review policy and its allow and block instructions.

Get Grok Bot Access`cursor_get_grok_bot_access`

Get whether every team member or only some billing groups can use Grok Bot.

Update Grok Bot Access`cursor_update_grok_bot_access`

Let every team member use Grok Bot, or only members of chosen groups.

Get Grok Bot Network Policy`cursor_get_grok_bot_network_policy`

Get the network egress policy for Grok Bot computers.

Replace Grok Bot Network Policy`cursor_replace_grok_bot_network_policy`

Replace the network egress policy and allowlist for Grok Bot computers.

List Grok Bot Team Rules`cursor_list_grok_bot_team_rules`

List the team rules Grok Bot follows, newest first.

Create Grok Bot Team Rule`cursor_create_grok_bot_team_rule`

Add a rule that Grok Bot follows for the whole team.

Update Grok Bot Team Rule`cursor_update_grok_bot_team_rule`

Rename, rewrite, or turn on or off a Grok Bot team rule.

Delete Grok Bot Team Rule`cursor_delete_grok_bot_team_rule`

Delete a Grok Bot team rule.

List Grok Bot Setup Manifests`cursor_list_grok_bot_setup_manifests`

List the setup manifests whose scripts prepare Grok Bot computers.

Upsert Grok Bot Setup Manifest`cursor_upsert_grok_bot_setup_manifest`

Create or replace a setup manifest with the scripts that prepare Grok Bot computers.

Delete Grok Bot Setup Manifest`cursor_delete_grok_bot_setup_manifest`

Delete a Grok Bot setup manifest.

List Unified Groups`cursor_unified_list_groups`

List unified directory groups in a Cursor team.

Get Unified Group`cursor_unified_get_group`

Get a unified Cursor directory group by ID.

List Unified Roles`cursor_unified_list_roles`

List the built-in team roles of Cursor.

Get Unified Role`cursor_unified_get_role`

Get a built-in Cursor team role by ID.

List Unified Users`cursor_unified_list_users`

List unified users in a Cursor team.

Get Unified User`cursor_unified_get_user`

Get a unified Cursor team member by ID.

Get Team Members`cursor_get_team_members`

List every member of the Cursor team with their role and removal status.

Remove Team Member`cursor_remove_team_member`

Remove a member from the Cursor team by user ID or email.

Get Model Access Configuration`cursor_get_model_access_configuration`

Get the Cursor team's model access policy and its defaults for new providers and models.

Update Model Access Configuration`cursor_update_model_access_configuration`

Turn on a custom model access policy for the Cursor team, change its defaults, or clear it.

List Model Access Providers`cursor_list_model_access_providers`

List model providers and their models with what the Cursor team allows for each.

Update Model Access Provider`cursor_update_model_access_provider`

Allow or block a whole model provider, such as openai or anthropic, for the Cursor team.

List Models For A Provider`cursor_list_models_for_a_provider`

List one provider's models with whether the Cursor team allows each and its parameter limits.

Update Model Access Model`cursor_update_model_access_model`

Allow or block one model for the Cursor team and limit its parameter values.

Start Grok Bot Computer Operation`cursor_start_grok_bot_computer_operation`

Recreate, stop or delete the Grok Bot computers and data of members of one Cursor team.

Get Grok Bot Computer Operation`cursor_get_grok_bot_computer_operation`

Get the progress of a Grok Bot computer operation, with the result for each member.

Get Latest Grok Bot Computer Operation`cursor_get_latest_grok_bot_computer_operation`

Get the most recent Grok Bot computer operation of one Cursor team.

List Organization Groups`cursor_list_organization_groups`

List the Cursor organization's groups with their member counts and spend limits.

Get Organization Group`cursor_get_organization_group`

Get one of the Cursor organization's groups by ID.

List Organization Group Members`cursor_list_organization_group_members`

List the members of one Cursor organization group.

Create Organization Group`cursor_create_organization_group`

Create a organization group with manually managed membership.

Update Organization Group`cursor_update_organization_group`

Rename a Cursor organization group or change its monthly spending limit.

Delete Organization Group`cursor_delete_organization_group`

Delete an empty Cursor organization group.

Add Organization Group Members`cursor_add_organization_group_members`

Add members to a manually managed Cursor organization group.

Remove Organization Group Members`cursor_remove_organization_group_members`

Remove members from a manually managed Cursor organization group.

List Organization Members`cursor_list_organization_members`

List the members of the Cursor organization with their organization role and the teams they belong to.

Sync Organization Team Memberships`cursor_sync_organization_team_memberships`

Set exactly which teams each Cursor organization member belongs to, for up to 500 members at once.

Get Organization Audit Logs`cursor_get_organization_audit_logs`

List audit log events across the Cursor organization and its teams.

List Model Access Configuration`cursor_list_model_access_configuration`

List the model access policy of each team in the Cursor organization.

Get Team Model Access Configuration`cursor_get_team_model_access_configuration`

Get the model access policy of one team in the Cursor organization.

Update Team Model Access Configuration`cursor_update_team_model_access_configuration`

Turn on a custom model access policy for one team in the Cursor organization, change its defaults, or clear it.

Bulk Update Model Access Configuration`cursor_bulk_update_model_access_configuration`

Apply the same model access policy to up to 100 teams in the Cursor organization.

Get Team Model Access Providers`cursor_get_team_model_access_providers`

List the model providers and models one Cursor team allows, with parameter limits.

Update Team Model Access Provider`cursor_update_team_model_access_provider`

Allow or block a model provider for one team in the Cursor organization.

Update Team Model Access Model`cursor_update_team_model_access_model`

Allow or block one model for one team in the Cursor organization and limit its parameter values.

Bulk Update Model Access Provider`cursor_bulk_update_model_access_provider`

Allow or block a model provider for up to 100 teams in the Cursor organization.

Bulk Update Model Access Model`cursor_bulk_update_model_access_model`

Allow or block one model for up to 100 teams in the Cursor organization and limit its parameter values.

Get Pooled Usage`cursor_get_pooled_usage`

Get the Cursor organization's pooled spend limit, how much is used and how much each team has spent.

Get Usage Events`cursor_get_usage_events`

List individual usage events across the Cursor organization's teams with model, tokens and charged cost.

Get Organization Daily Usage Data`cursor_get_organization_daily_usage_data`

List daily usage rows for every member across the Cursor organization's teams.

Get Organization Spending Data`cursor_get_organization_spending_data`

List each member's spend on each team across the Cursor organization for the current contract period.

Get Team Repo Blocklists`cursor_get_team_repo_blocklists`

List the repositories with blocklist patterns that keep files out of Cursor's AI features.

Upsert Repo Blocklists`cursor_upsert_repo_blocklists`

Create or replace the blocklist patterns of one or more repositories.

Delete Repo Blocklist`cursor_delete_repo_blocklist`

Delete the blocklist of one repository.

Get Daily Usage Data`cursor_get_daily_usage_data`

List the Cursor team's daily usage rows, one per member per day, with lines, accepts, requests and models used.

Get Spending Data`cursor_get_spending_data`

List each Cursor team member's spend in the current billing cycle with their spend limits.

Get Usage Events Data`cursor_get_usage_events_data`

List individual Cursor usage events with model, token usage and charged cost, filtered by user, agent or date.

Set User Spend Limit`cursor_set_user_spend_limit`

Set the monthly spend limit of one Cursor team member.

Set User Spend Limits In Bulk`cursor_set_user_spend_limits_in_bulk`

Set the spend limits of up to 100 Cursor team members in one request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.