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.
No operations match.
See How connections work for access and permissions, or browse all integrations.