Skip to main content
GET
Read or wait for a Computer Task result

Authorizations

token
string
query
required

Vida API Token

Path Parameters

targetAccountId
integer
required

Selected Computer Agent account.

Required range: x >= 1
taskId
string
required

Existing Computer Task ID.

Maximum string length: 100

Query Parameters

waitSeconds
integer
default:0

Maximum additional wait after the initial Task lookup.

Required range: 0 <= x <= 60

Response

Reply ready, or Task errored or canceled

success
boolean
required

Whether the API request succeeded, not whether the Task succeeded.

Example:

true

taskId
string
required

Existing Task ID.

state
enum<string>
required
Available options:
pending,
processing,
running,
finished,
errored,
canceled
resultStatus
enum<string>
required

Response-only readiness. Finished Tasks remain pending while their reply has not replicated. Unavailable indicates an errored or canceled Task.

Available options:
pending,
ready,
unavailable
output
object | null
required
error
object | null
required
resultRef
object
required