Cursor icon

Cursor

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

Actions13

Run → List

AI-generated

Summary

List runs for a specified agent, returning up to a user-defined maximum number of results.

Inputs

  • Agent ID (required) — ID of the agent that owns the run
  • Limit — Max number of results to return (between 1 and 100, default 25)

Output shape

a list of run objects as individual items

The operation returns an array of runs belonging to the specified agent. If the API response wraps runs under a field like 'items' or 'data', these are extracted to produce the list. If the response shape is unexpected, the entire response JSON is returned as a single item.

Links

Discussion