Konnectify
Cursor + Konnectify

Cursor Integration with Konnectify

Connect to the Cursor Cloud Agents API to launch, monitor, and manage AI coding agents that work on GitHub repositories from automated Konnectify workflows.

Agents Runs Artifacts Self-hosted Workers 0 Triggers 16 Actions
ON THIS PAGE

What is Cursor?

Cursor is an AI-powered development environment and coding platform built to help engineering teams write, review, and ship code faster. Cursor Cloud Agents can operate on GitHub repositories, run coding tasks from natural-language prompts, produce artifacts, and manage branches or pull request workflows.

With Konnectify, you can connect Cursor to the rest of your DevOps, support, and collaboration stack so that coding-agent work can be initiated, tracked, and routed automatically.

New to Cursor?

Create a Cursor account to start using AI coding tools and cloud-hosted coding agents.

Visit Cursor →

New to Konnectify?

Build no-code workflows that connect Cursor with your business and engineering apps.

Sign up for Konnectify →

What you can automate

• Launch new Cursor agents from prompts
• Retrieve agent metadata and repository settings
• Archive, unarchive, or delete agents
• Send follow-up prompts and cancel active runs
• List and download generated artifacts
• Monitor self-hosted workers, fleet usage, and pending pool requests

API & Authentication

Authentication method: API Key authentication

The Cursor connector uses credential-based API key authentication. Enter your Cursor API key when creating the connection in Konnectify. The optional Service Account API Key is used for worker and pool-related beta actions.

Konnectify securely stores your credentials and uses them only to call the Cursor API actions configured in your workflows.

API capabilities

  • Create, list, retrieve, archive, unarchive, and delete agents
  • Create, list, retrieve, and cancel agent runs
  • List and download agent workspace artifacts
  • Inventory beta self-hosted workers and fleet capacity

Official documentation

Refer to Cursor’s official API documentation for endpoint behavior, supported fields, and account requirements.

Open Cursor API docs →
Note: Cursor API availability, beta worker endpoints, plan access, and rate limits may vary by Cursor account or team configuration. If an action fails with an authorization, quota, or rate-limit error, verify your Cursor plan and API key permissions.

How to Connect Cursor to Konnectify

Prerequisites

  • A Konnectify account with permission to create or edit workflows
  • A Cursor account with access to the Cursor Cloud Agents API
  • Your Cursor API key
  • A service account API key if you plan to use beta worker and pool actions
  • Repository access in GitHub if your agents will operate on repositories
1

Add Cursor to a Workflow

  1. Open Konnectify and create a new workflow or edit an existing one.
  2. Add a Cursor action step where you want the automation to manage agents, runs, artifacts, or workers.
2

Authorize via API Key authentication

  1. Select Add new connection for Cursor.
  2. Enter your Cursor API key in the API Key field.
  3. Optionally enter a Service Account API Key for worker actions.
  4. Save the connection.
3

Configure the Trigger or Action

  1. Select the Cursor action you want to run.
  2. Map required fields such as agent ID, run ID, artifact ID, repository settings, or prompt text.
  3. Use outputs from earlier workflow steps to dynamically create prompts or select agents.
Important: Actions like Delete Agent are permanent, and Cancel Run is terminal. Test these actions carefully before activating production workflows.
4

Test the Workflow

  1. Run a test with sample input data.
  2. Confirm that Cursor returns the expected agent, run, artifact, or worker response.
  3. Review any Cursor API errors and update field mappings as needed.
5

Activate the Workflow

  1. Turn on the workflow when your test results are correct.
  2. Monitor workflow runs in Konnectify and review Cursor run status for long-running agent tasks.

Triggers 0

The Cursor connector currently includes 0 native triggers. You can still automate Cursor by starting workflows from other apps, schedules, webhooks, forms, ticket events, repository events, or any other Konnectify trigger, then adding Cursor actions.

No Cursor trigger events are available in this version of the connector.

Actions 16

Use Cursor actions to create and manage cloud agents, continue runs, retrieve artifacts, and monitor beta self-hosted worker capacity.

Agents 6 actions
Create Agent

Creates a new Cursor cloud agent against a repository (or no repo) and immediately enqueues its first run based on a natural-language prompt.

List Agents

Retrieves the authenticated user's cloud agents, newest first.

Get Agent

Retrieves full durable metadata for a single cloud agent, including its repo configuration and branch/PR settings.

Archive Agent

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

Unarchive Agent

Unarchives an agent so it can accept new runs again.

Delete Agent

Permanently and irreversibly deletes an agent and its history.

Runs 4 actions
Create Run

Sends a follow-up prompt to an existing agent, continuing its current conversation and workspace state.

List Runs

Retrieves the run history for an agent, newest first.

Get Run

Retrieves status, timestamps, and (for terminal runs) the final result, duration, and pushed branches for a specific run.

Cancel Run

Cancels the active run for an agent. Cancellation is terminal; the run transitions to CANCELLED and cannot be resumed.

Artifacts 2 actions
List Artifacts

Lists files an agent's workspace has produced, such as screenshots or generated assets, for later download.

Download Artifact

Retrieves a temporary 15-minute presigned S3 URL for a specific artifact.

Self-hosted Workers 4 actions
List Workers [Beta]

Inventories self-hosted pool workers for the authenticated service account's team, newest first.

Get Worker [Beta]

Retrieves details for a single self-hosted pool worker.

Get Fleet Summary [Beta]

Returns connected and in-use worker counts for the authenticated user and their team, to drive autoscaling decisions.

List Pending Pool Requests [Beta]

Lists self-hosted pool requests that have not been assigned to a worker yet, to help scale capacity while users are waiting.

Popular Automations

Combine triggers from your project management, support, repository, and chat tools with Cursor actions to automate engineering workflows.

Turn approved issues into coding-agent tasks

When a product or engineering issue is approved, launch a Cursor cloud agent with the issue description as the prompt.

Issue Approved Create Agent

Send follow-up instructions from team chat

Let developers or support engineers post a structured message that continues an existing Cursor agent’s conversation.

New Chat Command Create Run Get Run

Collect generated screenshots and assets

After an agent completes a task, list its workspace artifacts and retrieve a temporary download URL for files your team needs.

Run Completed List Artifacts Download Artifact

Monitor self-hosted worker capacity

Run scheduled checks against Cursor’s beta worker pool endpoints and notify your team when pending requests indicate more capacity is needed.

Scheduled Check Get Fleet Summary [Beta] List Pending Pool Requests [Beta]

FAQ

How does Cursor authentication work in Konnectify?
Cursor uses API key authentication. Add your Cursor API key when creating the connection. For beta worker and pool actions, add the service account API key if your Cursor team uses self-hosted workers.
Which Cursor plans are supported?
Any Cursor account or team with access to the required Cursor Cloud Agents API endpoints can be connected. Some capabilities, especially beta self-hosted worker actions, may require specific Cursor team settings, API access, or service account permissions.
How do Cursor triggers work?
This version of the Cursor connector does not include native Cursor triggers, so there are no Cursor polling or webhook events to configure. Start workflows from other apps, schedules, or webhook triggers, then use Cursor actions within the workflow.
How can I prevent duplicate agents or duplicate runs?
The connector does not include an upsert action. To avoid duplicates, store the Cursor agent ID or run ID in your source system after creation, check existing records before calling Create Agent or Create Run, and add workflow conditions that skip creation when an ID already exists.
How does Konnectify handle Cursor rate limits?
Cursor API rate limits are enforced by Cursor. If a workflow receives a rate-limit response, reduce the frequency of scheduled checks, add delays between high-volume actions, or configure workflow retry behavior according to your Konnectify plan and operational requirements.
Can I connect multiple Cursor accounts?
Yes. Create separate Cursor connections in Konnectify using different API keys or service account keys. When building a workflow, select the connection that corresponds to the Cursor account or team you want that workflow to use.
Can Cursor agents work on GitHub repositories, branches, and pull requests?
Yes, Cursor cloud agents can be created against repositories when your Cursor and GitHub access are configured correctly. The Get Agent action returns durable repository configuration and branch or pull request settings, while Get Run can return final results and pushed branches for terminal runs.

Ready to automate your Cursor workflows?

Connect Cursor to Konnectify and orchestrate cloud coding agents across your engineering stack.

Get started free →

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article