Back

Get agent status

This query returns the current status and details of a Cursor cloud agent, including its latest run status, the final result text, and the pull request URL if one was created.

Developer info

API endpoint slug: cursor.get_agent_status
Runtime method: performQuery("cursor.get_agent_status"}

Query fields

Agent Text input > Other

Label: Agent ID
Helper text: The ID of the Cursor agent to check (e.g. bc-3a1b9c...).
Slug: agent_id
Required: true
Can have default value: true

Ingredients

Agent The unique identifier of the agent.

Slug: agent_id
Filter code: Cursor.getAgentStatus.AgentId
Type: String
Example: bc-3a1b9c00-0000-0000-0000-000000000001

Agent name The name assigned to the agent.

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

Run status Status of the agent's latest run (CREATING, RUNNING, FINISHED, ERROR, CANCELLED, or EXPIRED).

Slug: run_status
Filter code: Cursor.getAgentStatus.RunStatus
Type: String
Example: FINISHED

Repository The GitHub repository the agent is working on.

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

Created at Timestamp when the agent was created.

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

Result The agent's final reply text. Empty until the run reaches a terminal state.

Slug: result
Filter code: Cursor.getAgentStatus.Result
Type: String
Example: Added README.md with setup instructions and opened a pull request.

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

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

Applets using this Query