Skip to content
Changelog

Report a bug

Cursor integration: operations for AI agents

Cursor connects to Type.com as an integration. This page lists the 37 operations documented for Claude and Codex in Type.com: 20 read, 7 write, 10 destructive.

About Cursor

Cursor is an AI-powered code editor built on VSCode. The API provides access to Cloud Agents, Admin, Analytics, and AI Code Tracking features.

Categories: Developer Tools & IT

How to connect Cursor to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

37 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

37 operations listed.

Agents

  • Read

    List agents

    List agents for the authenticated user, newest first.

  • Read

    Get an agent

    Retrieve durable metadata for an agent. Execution status lives on runs.

  • Read

    List runs

    List runs for an agent, newest first.

  • Read

    Get a run

    Retrieve status and timestamps for a specific run.

  • Read

    Stream a run

    Stream Server-Sent Events for one run. Event types are status, assistant, thinking, toolcall, interactionupdate, heartbeat, result, error, and done. - status carries { runId, status }. It has no id line and is replayed at the top of every reconnect.

  • Read

    Get agent usage

    Retrieve token usage for an agent, broken down per run. totalUsage sums input, output, and cache token counts across every run on the agent, and runs lists the same breakdown for each run. Token usage mirrors the tokenUsage shape on the team usage events endpoint.

  • Read

    List artifacts

    List artifacts produced by an agent. Each artifact's path is relative to the workspace's artifacts/ directory. Pass that path to GET /v1/agents/{id}/artifacts/download to obtain a presigned download URL.

  • Read

    Download an artifact

    Retrieve a temporary 15-minute presigned S3 URL for an artifact. The path query parameter must be a relative path under artifacts/ returned by GET /v1/agents/{id}/artifacts.

  • Write

    Create an agent

    Create a Cloud Agent and immediately enqueue its initial run. The response contains both the durable agent and the initial run.

  • Write

    Send a follow-up or steer

    Send a follow-up prompt to an existing active agent. Without delivery, the prompt starts a new run that uses the agent's current conversation and workspace state, and only one run can be active per agent at a time.

  • Write

    Unarchive an agent

    Unarchive an agent so it can accept new runs again.

  • Destructive

    Delete an agent permanently

    Permanently delete an agent. This action is irreversible. Use POST /v1/agents/{id}/archive for reversible removal.

  • Destructive

    Cancel a run

    Cancel the active run for an agent. Cancellation is terminal — the run transitions to CANCELLED. Cancelling a run that is already terminal or was never active returns 409 runnotcancellable. To continue the conversation, create a new run on the same agent.

  • Destructive

    Archive an agent

    Archive an agent. Archived agents remain readable but cannot accept new runs until unarchived.

Environments

  • Read

    List environments

    List the saved environments the API key can access, most recently updated first. Without userId, the list includes the user's personal environments and the team's environments.

  • Read

    Get an environment

    Retrieve a saved environment, its latest saved configuration, and its build settings. An environment that doesn't exist or isn't visible to the API key returns 404 environmentnotfound.

  • Read

    List environment history

    List the changes to an environment, newest first, as its History tab in the dashboard shows them. An environment that doesn't exist or isn't visible to the API key returns 404 environmentnotfound.

  • Read

    List environment builds

    List an environment's builds, newest first. Filter them by status or creation time. An environment that doesn't exist or isn't visible to the API key returns 404 environmentnotfound.

  • Read

    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. An environment that doesn't exist or isn't visible to the API key returns 404 environmentnotfound.

  • Read

    Get an environment build

    Retrieve one of an environment's builds. An environment that doesn't exist or isn't visible to the API key returns 404 environmentnotfound, and a build ID that isn't one of the environment's builds returns 404 buildnotfound.

  • Read

    List environment secrets

    List an environment's Cloud Agents secrets, one item per version, sorted by name. No item includes a value. The list isn't paginated yet, so nextCursor is always null.

  • Write

    Create an environment

    Create a saved environment. The 201 response is the new environment.

  • Write

    Update an environment

    Rename an environment, replace its configuration, replace its repositories, or any combination. A request applies every field it sends together, so either all of them change or none do. Change build settings with buildSettings in a request of its own.

  • Write

    Start an environment build

    Start a build of the environment. Access follows PATCH /v1/environments/{id}, except that a draft build on a team environment needs only read access, and service account API keys and repository-limited tokens are refused. Service account API keys get 403 keynotsupported.

  • Destructive

    Delete an environment

    Permanently delete a saved environment. This action is irreversible.

  • Destructive

    Set an environment secret

    Create an environment secret, rotate its value, or change its type or repositories. With ?id=, the request changes that version.

  • Destructive

    Delete an environment secret

    Delete one version of an environment secret. This action is irreversible. With ?id=, the request deletes that version.

Me

  • Read

    API key info

    Retrieve information about the API key being used for authentication.

  • Destructive

    Set a personal secret

    Create a personal secret for the user the API key acts for, rotate its value, or change its type or repositories. With ?id=, the request changes that version.

  • Destructive

    Delete a personal secret

    Delete one version of a personal secret of the user the API key acts for. This action is irreversible. With ?id=, the request deletes that version.

Models

  • Read

    List models

    Returns a recommended set of explicit model IDs you can pass to the model.id field on POST /v1/agents. To use the configured default model, omit the model field from the request body entirely.

Repositories

  • Read

    List GitHub repositories

    List GitHub repositories accessible to the authenticated user through Cursor's GitHub App installation.

Team

  • Read

    List team secrets

    List the Cloud Agents secrets of the team the API key works in, one item per version, sorted by name. No item includes a value. The list isn't paginated yet, so nextCursor is always null. Any team member can list, as can the team's service account API keys.

  • Destructive

    Set a team secret

    Create a secret for the team the API key works in, rotate its value, or change its type or repositories. With ?id=, the request changes that version.

  • Destructive

    Delete a team secret

    Delete one version of a secret from the team the API key works in. This action is irreversible. With ?id=, the request deletes that version.

Sub tokens

  • Write

    Create A User-Scoped Worker Token

    Create a one-hour user-scoped token for a My Machines worker to run as an active team member. Requires an agent-scoped team service account API key. User-scoped tokens can't mint other user-scoped tokens.

Secrets

  • Read

    List secrets

    List every Cloud Agents secret the API key can list, one item per version, with the owner that holds it. No item includes a value.

See How connections work for access and permissions, or browse all integrations.