Skip to main content
POST
CreateAttempt

Authorizations

Authorization
string
header
required

A user session token or personal API key.

Headers

Connect-Protocol-Version
number
required

Define the version of the Connect protocol

Example:

1

Connect-Timeout-Ms
number

Define the timeout, in ms

Example:

1000

Body

application/json
attempt
attempt · object
required

One dispatch of a Call to compute.

parent
string

Response

Success

One dispatch of a Call to compute.

name
string

Resource name in the form runs/{run}/calls/{call}/attempts/{positive-integer}. The integer is the one-based ordinal within its Call; ordinals are contiguous and never reused.

Pattern: ^runs/[0-9a-f-]{36}/calls/[0-9a-f]{64}/attempts/[1-9][0-9]*$
state
enum<string>

Current externally observable lifecycle state of this dispatch.

Available options:
STATE_UNSPECIFIED,
STATE_PENDING,
STATE_RUNNING,
STATE_COMPLETED,
STATE_FAILED,
STATE_CANCELLED,
STATE_CANCELLING
output
string<byte> | null

cloudpickle of the successful return value, when one exists.

outputRepr
string | null

Truncated repr of the successful return value, when one exists.

errorMessage
string | null

Failure or cancellation explanation, when one exists.

created_at
string<date-time>

Time this Attempt was durably created.

Example:

"2023-01-15T01:30:15.01Z"

started_at
string<date-time>

Time the Attempt's code began, as its runtime reported it once it finished; until then, the time the node claimed the Attempt.

Example:

"2023-01-15T01:30:15.01Z"

updated_at
string<date-time>

Time of the most recent observed lifecycle transition.

Example:

"2023-01-15T01:30:15.01Z"

finished_at
string<date-time>

Time the Attempt's code ended, as its runtime reported it; otherwise when it became terminal.

Example:

"2023-01-15T01:30:15.01Z"

sandbox
string

The sandbox it runs in, once started on a node.