Skip to main content
GET
/
v1
/
get_job_status
/
{job_id}
{
  "job_id": "<string>",
  "user_id": "<string>",
  "directive": "<string>",
  "status": "running",
  "output": "<any>",
  "error": "<string>",
  "live_url": "<string>",
  "cdp_url": "<string>",
  "history_url": "<string>",
  "credits_used": 123,
  "credit_balance": 123,
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Get your API key at https://app.heytessa.ai/settings

Path Parameters

​
job_id
string
required

The unique job identifier returned when starting the browser agent

Response

Job status retrieved successfully

Represents the current state of a job as stored in the jobs table.

​
job_id
string
required

Unique identifier for the job

​
user_id
string
required

The user who owns this job

​
status
enum<string>
required

Current job status

Available options:
running,
completed,
failed,
user_taken_over
​
directive
string | null

The instruction the agent was asked to perform

​
output
any

Final output, if completed. Arbitrary JSON.

​
error
string | null

Error message if the job failed

​
live_url
string | null

Direct link to watch the live browser session. You can observe the agent working in real-time and take control if needed

​
cdp_url
string | null

Chrome DevTools Protocol URL. Only needed if you want to connect your own automation tools to control the browser

​
history_url
string | null

Link to the Tessa platform where you can view live session, action history, detailed logs, and take over control

​
credits_used
integer | null

Number of credits consumed by this job

​
credit_balance
integer | null

User's remaining credit balance

​
created_at
string | null

Creation timestamp (ISO8601)

​
updated_at
string | null

Last updated timestamp (ISO8601)

⌘I