Back

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 code: Cursor.listAgents.AgentId
Type: String
Example: bc-3a1b9c00-0000-0000-0000-000000000001

Agent name The name assigned to the agent.

Slug: agent_name
Filter code: 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 code: Cursor.listAgents.AgentStatus
Type: String
Example: ACTIVE

Repository The GitHub repository the agent is working on.

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

Created at Timestamp when the agent was created.

Slug: created_at
Filter code: 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 code: 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 code: Cursor.listAgents.AgentUrl
Type: Web URL
Example: https://cursor.com/agents/bc-3a1b9c00-0000-0000-0000-000000000001

Applets using this Query