Cursor icon

Cursor

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

Actions13

Agent → List

AI-generated

Summary

Retrieve a list of AI coding agents, up to a specified maximum number of results.

Inputs

  • Limit — The maximum number of agents to return in the list (minimum 1, maximum 100, default is 25).

Output shape

a list of agent objects, each representing an AI coding agent

The operation returns an array of agents under the 'items' or 'data' property from the API response. Each item in the output corresponds to one agent object returned by the Cursor API. Pagination is limited by the 'Limit' input parameter.

Examples

Example 1: List the first 10 agents

Set Limit to 10

Example 2: List agents with default limit

Use the default Limit parameter (25)

Links

Discussion