Cursor icon

Cursor

Interact with the Cursor REST API to spawn and manage AI coding agents

Actions13

Agent → Resume

AI-generated

Summary

Send a prompt message to an existing agent to resume its operation and wait for the run to complete, returning the final status and result.

Inputs

  • Agent ID (required) — The identifier of the agent to resume.
  • Message (required) — The prompt message text to send to the agent.
  • Model — The model ID to use with the agent (default is 'composer-2').

Output shape

A single JSON object with the run status, textual result, run ID, and agent ID.

The operation performs an HTTP POST to create a new run with the prompt message, then polls every 5 seconds up to 10 minutes until the run completes or errors. If the run ID is missing, returns agent info without polling.

Links

Discussion