{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"autoCreatePR": {
"type": "boolean",
"description": "Whether Cursor should open a pull request when the run completes."
},
"autoGenerateBranch": {
"type": "boolean",
"description": "Whether to create a new branch (true) or push to an existing head branch (false). Only applies when `repos[0].prUrl` is provided."
},
"branchName": {
"type": "string",
"description": "Custom branch name for the agent to create."
},
"envVars": {
"type": "object",
"description": "Session-scoped environment variables for the cloud agent. Values are encrypted at rest, injected into the agent's shell, and deleted with the agent. Names must be non-empty, 1024 bytes or less, and cannot start with `CURSOR_`. Values must be non-empty and 4096 bytes or less."
},
"model": {
"type": "object",
"description": "The model value",
"properties": {
"id": {
"type": "string",
"description": "Explicit model ID returned by GET /v1/models. Omit `model` from the request to use the configured default."
},
"params": {
"type": "array",
"items": {
"type": "object"
},
"description": "Per-model parameters such as reasoning effort or max mode. Use only parameters supported by the selected model."
}
},
"required": [
"id"
]
},
"prompt": {
"type": "object",
"description": "The prompt value",
"properties": {
"text": {
"type": "string",
"description": "Task instruction for the agent."
},
"images": {
"type": "array",
"items": {
"type": "object"
},
"description": "Optional base64-encoded images. Maximum 5 images, 15 MB each."
}
},
"required": [
"text"
]
},
"repos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "GitHub repository URL. Required unless `prUrl` is provided."
},
"startingRef": {
"type": "string",
"description": "Branch, tag, or commit hash to use as the starting point."
},
"prUrl": {
"type": "string",
"format": "uri",
"description": "GitHub pull request URL. When provided, the agent works on this PR's repository and branches; `url` and `startingRef` are ignored."
}
}
},
"description": "Repository configuration. v1 currently supports one entry."
},
"skipReviewerRequest": {
"type": "boolean",
"description": "Whether to skip requesting the user as a reviewer when Cursor opens a PR. Only applies when `autoCreatePR` is true."
}
},
"required": [
"PCID",
"prompt",
"repos"
]
}