Skip to main content
GET
/
v0
/
agents
/
{id}
Get agent status
curl --request GET \
  --url https://cloud.firebender.com/v0/agents/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "fb_abc123xyz789",
  "name": "Add README Documentation",
  "status": "CREATING",
  "source": {
    "repository": "https://github.com/your-org/your-repo",
    "ref": "main"
  },
  "target": {
    "branchName": "firebender/abc123xyz789",
    "url": "https://preview-sandbox-id.pit-1.try-eu.daytona.app/vnc.html",
    "prUrl": "https://github.com/your-org/your-repo/pull/1234",
    "autoCreatePr": false
  },
  "createdAt": "2024-01-15T10:30:00Z",
  "summary": "Added README.md with installation instructions and usage examples",
  "vncUrl": "https://preview-sandbox-id.pit-1.try-eu.daytona.app/vnc.html",
  "vncToken": "eyJhbGciOiJIUzI1NiIs...",
  "recordingUrl": "https://cloud.firebender.com/v1/recordings/fb_abc123xyz789",
  "traceUrl": "https://cloud.firebender.com/v1/traces/fb_abc123xyz789"
}

Authorizations

​
X-API-Key
string
header
required

API key from Firebender Dashboard

Path Parameters

​
id
string
required

Unique identifier for the cloud agent

Example:

"fb_abc123xyz789"

Response

Agent details retrieved successfully

​
id
string
required

Unique identifier for the cloud agent

Example:

"fb_abc123xyz789"

​
name
string
required

Name for the agent (derived from prompt)

Example:

"Add README Documentation"

​
status
enum<string>
required

Current status of the cloud agent:

  • CREATING: Sandbox is being provisioned — cloning repo, installing JDK, running setup scripts
  • SETUP: Android Studio and the Firebender plugin have launched. The project is running Gradle sync and indexing. VNC preview is available.
  • RUNNING: Agent is actively working on the task
  • FINISHED: Agent completed successfully (also set when an agent is stopped)
  • ERROR: Agent encountered an error
  • EXPIRED: Agent timed out
Available options:
CREATING,
SETUP,
RUNNING,
FINISHED,
ERROR,
EXPIRED
​
source
object
required
​
target
object
required
​
createdAt
string<date-time>
required

When the agent was created

Example:

"2024-01-15T10:30:00Z"

​
summary
string

Summary of the agent's work (available after completion)

Example:

"Added README.md with installation instructions and usage examples"

​
vncUrl
string

Direct VNC URL for the agent's live preview (only present on GET agent by ID, while agent is active)

Example:

"https://preview-sandbox-id.pit-1.try-eu.daytona.app/vnc.html"

​
vncToken
string

Authentication token for the VNC session (only present on GET agent by ID, while agent is active)

Example:

"eyJhbGciOiJIUzI1NiIs..."

​
recordingUrl
string<uri>

URL to the emulator screen recording. Available for mobile_use and debug_auto agents after completion. Returns a redirect to a time-limited presigned URL for the video file.

Example:

"https://cloud.firebender.com/v1/recordings/fb_abc123xyz789"

​
traceUrl
string<uri>

URL to the agent execution trace. Enterprise only. Available after agent completion.

Example:

"https://cloud.firebender.com/v1/traces/fb_abc123xyz789"