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

# Cursor

## After this article

You'll be able to connect Cursor to Lumos and sync your Cursor team members, their teams and roles, and last-login activity for visibility and Access Reviews.

## Capabilities

| Functionality | Type | Sync | Provision | Description |
| - | - | - | - | - |
| Users | Account | Yes | No | User account records |
| Team | Permission | Yes | No | Teams in Cursor |
| Roles | Permission | Yes | No | Roles in Cursor |

## Required plan and roles

* **Cursor role:** you create the API key from the **Admin API Keys** section of the Cursor dashboard, so the person connecting needs admin access to your Cursor team.
* **Permission scoping:** this is a **read-only** integration. Lumos syncs users, teams, roles, and activity but doesn't provision or deprovision anything in Cursor.
* **Activity tracking:** supported. The integration syncs each user's last login, derived from team audit logs.

## Read-only access vs provisioning

**Is read-only possible?** Yes. This is a read-only integration.

**What read-only requires.** An Admin API key created from Settings, then Advanced, then Admin API Keys in the Cursor dashboard, by someone with admin access to your Cursor team. Follow the steps below.

**Watch out for.** Cursor shows the Admin API key only once, at creation, so save it immediately or you will need to generate a new one and reconnect. There is no provisioning mode to switch to. Creating users, changing roles, or deactivating accounts has to be done directly in Cursor.

## Instructions

**Phase 1: Create an Admin API key in Cursor**

1. Go to [cursor.com/dashboard](https://cursor.com/dashboard), then open the **Settings** tab > **Advanced** > **Admin API Keys**.
2. Click **Create New API Key**.
3. Give it a descriptive name, for example `Lumos Integration`.
4. Copy the generated key right away. You won't be able to see it again. Keep it secure, the same as a password.

**Phase 2: Connect in Lumos**

1. Find the Cursor card in your Lumos integrations (reconnect an existing card or add a new one).
2. Enter the Admin API key into the **API Authorization Key** field.
3. Click **Connect**.

## API Endpoints Used

<Note>
  The API endpoints this integration uses are available to logged-in Lumos customers. [Log in](/login) to view them.
</Note>

## Troubleshooting

**You lost the API key or it no longer works.** Cursor shows the Admin API key only once at creation. If you didn't save it, create a new key under **Settings > Advanced > Admin API Keys** and reconnect in Lumos.

**You're expecting provisioning actions.** The Cursor integration supports read operations only. You need to create users, change roles, and deactivate accounts in Cursor directly.