Skip to main content
GET
Get run by ID

Authorizations

X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Path Parameters

id
string
required

Run ID

Pattern: ^[A-Za-z0-9_-]+$
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Query Parameters

screenshots
enum<string>
default:url

Screenshot delivery mode. url: absolute URLs to screenshot images. base64: inline data URIs. none: omit screenshots. Defaults to url.

Available options:
base64,
url,
none
Example:

"url"

html
enum<string>
default:url

HTML snapshot delivery mode. url: absolute URLs to HTML snapshot pages (only non-null when capture_config.html was enabled). none: omit HTML URLs. Defaults to url.

Available options:
url,
none
Example:

"url"

Response

Run details

A single automation run

run_id
string
required

Unique identifier for the run

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

status
enum<string>
required

Current status of the run

Available options:
PENDING,
RUNNING,
COMPLETED,
FAILED,
CANCELLED
Example:

"COMPLETED"

goal
string
required

Natural language goal for this automation run

Example:

"Find all pricing information"

created_at
string
required

ISO 8601 timestamp when run was created

Example:

"2026-01-14T10:30:00Z"

started_at
string | null
required

ISO 8601 timestamp when run started executing

Example:

"2026-01-14T10:30:05Z"

finished_at
string | null
required

ISO 8601 timestamp when run finished

Example:

"2026-01-14T10:31:30Z"

num_of_steps
integer | null
required

Number of steps taken during the automation run. Null while the run is still in progress.

Required range: x >= 0
Example:

5

result
object | null
required

Extracted data from the automation run

output_schema
object | null
required

Provider-supported structured-output schema subset originally requested for this run. Null when no output_schema was provided.

Example:
profile_attached
boolean
required

Whether this run attached a Browser Context Profile internally.

Example:

true

profile_id
string | null
required

Browser Context Profile ID attached to this run, or null when no profile attached.

Example:

"prof_abc123"

error
object | null
required

Error details. Null if the run succeeded or is still running.

streaming_url
string | null
required

URL to watch live browser session (available while running)

Example:

"https://stream.agent.tinyfish.ai/session/xyz"

browser_config
object | null
required

Browser configuration used for the run

video_url
string | null
required

Presigned URL to the video recording of this run. Null if no recording is available. URL expires after 15 minutes.

Example:

"https://s3.amazonaws.com/bucket/eva-traces/run-id/video/recording.webm?..."

steps
object[]
required

Steps the agent took during this run.