AppRun

Record of a single app execution. Tracks input data, output results, and execution status from creation to completion.

Properties

idstring

Unique run identifier (UUID)

app_idstring

ID of the app this run belongs to

workflow_idstring

ID of the underlying workflow that was executed

data_idstring

ID of the data row created in the workflow for this run

user_emailstring

Email of the user who triggered the run

org_idstring

Organization ID

input_dataobject

Input values provided when the run was started, keyed by each field's `reference` from the app's `input_schema`

output_dataobject (nullable)

Output values produced by the workflow, keyed by each output field's `name` from the app's `output_schema`. Null until the run completes.

statusstring

Current execution status. Terminal states: completed, failed, error, outOfCredits. In-progress states: pending, inProgress, payloadFilled, readyToBeReviewed, checkingNextSource.

"pending""inProgress""completed""failed""payloadFilled""readyToBeReviewed""checkingNextSource""conditionNotMet""error""outOfCredits""duplicate"

error_messagestring (nullable)

Error details if the run failed. Null on success.

created_atstring <date-time>

When the run was created

completed_atstring <date-time> (nullable)

When the run finished (completed or failed). Null while in progress.

Example

AppRun example

{
  "id": "f1a2b3c4-d5e6-7f8a-9b0c-1d2e3f4a5b6c",
  "app_id": "string",
  "workflow_id": "string",
  "data_id": "string",
  "user_email": "string",
  "org_id": "string",
  "input_data": {},
  "output_data": {},
  "status": "pending",
  "error_message": "string",
  "created_at": "1970-01-01T00:00:00.000Z",
  "completed_at": "1970-01-01T00:00:00.000Z"
}