Explore Plans
Cursor

List agents

This query returns the Cursor cloud agents belonging to the authenticated account, one record per agent, most recent first.

Developer info

API endpoint slug
cursor.list_agents
Runtime method
performQuery("cursor.list_agents"}

Query fields

Include archived Dropdown list

Label
Include archived agents?
Helper text
Archived agents are included by default. Choose No to list only active agents.
Slug
include_archived
Required
true
Can have default value
true

Ingredients

Agent The unique identifier of the agent.

Slug
agent_id
Filter
Cursor.listAgents.AgentId
Type
String
Example
bc-3a1b9c00-0000-0000-0000-000000000001

Agent name The name assigned to the agent.

Slug
agent_name
Filter
Cursor.listAgents.AgentName
Type
String
Example
Add README with setup instructions

Agent status Lifecycle status of the agent (ACTIVE or ARCHIVED).

Slug
agent_status
Filter
Cursor.listAgents.AgentStatus
Type
String
Example
ACTIVE

Repository The GitHub repository the agent is working on.

Slug
repository
Filter
Cursor.listAgents.Repository
Type
String
Example
github.com/ifttt/shimmy

Created at Timestamp when the agent was created.

Slug
created_at
Filter
Cursor.listAgents.CreatedAt
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00

Pull request url URL of the pull request the agent created, if one exists.

Slug
pull_request_url
Filter
Cursor.listAgents.PullRequestUrl
Type
Web URL
Example
https://github.com/ifttt/shimmy/pull/123

Agent url URL to view the agent in Cursor.

Slug
agent_url
Filter
Cursor.listAgents.AgentUrl
Type
Web URL
Example
https://cursor.com/agents/bc-3a1b9c00-0000-0000-0000-000000000001