Launch Agent

POST

Query

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Body

Arguments

stringrequired

Task or instructions for the agent to execute.

string

GitHub repository URL for the agent to work in. Required unless using Source PR URL.

string

Branch, tag, or commit hash to use as the base ref.

string

Explicit model ID from List Models, or `default` to use Cursor's configured default.

boolean

Whether Cursor should automatically create a pull request when the agent completes.

Uncommon arguments

string

Custom branch name for the agent to create.

string

GitHub pull request URL. When provided, Cursor works on the PR repository and branches.

boolean

Open the pull request as the Cursor GitHub App. Only applies when Auto Create PR is true.

boolean

Skip adding the user as reviewer when PR is opened by the Cursor GitHub App.

boolean

Whether to create a new branch when Source PR URL is provided. Defaults to true.

string

URL to receive agent status-change webhook notifications.

string

Secret for webhook payload verification, minimum 32 characters.

array of object

Optional array of base64 encoded images, maximum 5.

curl --request POST \ --url "https://connect.mindcloud.co/v1/universal/cursor/0.0.2/actions/launch-agent" \ --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "connectionId": "$CONNECTION_ID", "prompt.text": "", "model": "default" }'

{ "success": true, "data": [ { "createdAt": "2026-05-07T12:00:00.000Z", "id": "string", "name": "Ava Chen", "source": { "ref": "string", "repository": "string" }, "status": "string", "target": { "autoCreatePr": true, "branchName": "string", "openAsCursorGithubApp": true, "prUrl": "https://example.com", "skipReviewerRequest": true, "url": "https://example.com" } } ], "meta": {} }

Query

Body

Every app you connect,one REST pattern