Air APIAPI ReferenceRuns

Get details of a specific run

View as Markdown

Retrieve the run’s details.

Required scope: air:simulation_read (roles: air_org_admin, air_user)

Alternative: role air_trainee also grants access.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"
A UUID string identifying this run.

Response

idstringRead-onlyformat: "uuid"
namestring<=128 characters
A customizable name for the run.
simulationstringRead-onlyformat: "uuid"
started_fromstring or nullRead-onlyformat: "uuid"
The checkpoint from which the run started.
started_atdatetimeRead-only
The time when the run first started.
ended_atdatetime or nullRead-only

The time when the run ended; if null, the run is ongoing.

createddatetimeRead-only
modifieddatetimeRead-only

Errors

403
Forbidden Error
404
Not Found Error
500
Internal Server Error