ShortcutRun

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

Properties

idstring

Unique run identifier (UUID)

app_idstring

ID of the shortcut 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

catalog_release_versionintegermin 1

Published source shortcut version used by this global run. Absent for ordinary shortcuts.

credits_usednumber (nullable)

Actual net credits charged, after refunds. Null when unavailable.

originobject
typestring
"listing""workflow""api""manual""ackdb"
workflow_idstring (nullable)
workflow_namestring (nullable)
data_idstring (nullable)
action_idstring (nullable)
stepsarray of

Read-only step results from the executed version; requested with include_steps=true.

idstring
namestring
action_namestring
statusstring
errorstring (nullable)
credits_usednumber (nullable)
outputsarray of
idstring
namestring
value
typestring
"sectionList"
columnsarray of

List columns from the executed version.

responseIdstring
responseStructureIdstring
namestring
typestring
steps_errorstring (nullable)
input_schemaarray of

Frozen input contract for this global run.

InputField
output_schemaarray of

Frozen output contract for this global run.

OutputConfig
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 shortcut's `input_schema`

output_dataobject (nullable)

Output values produced by the workflow, keyed by each output field's `name` from the shortcut'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

ShortcutRun example
{
  "id": "f1a2b3c4-d5e6-7f8a-9b0c-1d2e3f4a5b6c",
  "app_id": "string",
  "workflow_id": "string",
  "data_id": "string",
  "catalog_release_version": 0,
  "credits_used": 0,
  "origin": {
    "type": "listing",
    "workflow_id": "string",
    "workflow_name": "string",
    "data_id": "string",
    "action_id": "string"
  },
  "steps": [
    {
      "id": "string",
      "name": "string",
      "action_name": "string",
      "status": "string",
      "error": "string",
      "credits_used": 0,
      "outputs": [
        {
          "id": "string",
          "name": "string",
          "value": null,
          "type": "sectionList",
          "columns": [
            {
              "responseId": null,
              "responseStructureId": null,
              "name": null,
              "type": null
            }
          ]
        }
      ]
    }
  ],
  "steps_error": "string",
  "input_schema": [
    {
      "reference": "linkedin_url",
      "name": "LinkedIn URL",
      "description": "Full LinkedIn company profile URL",
      "type": "text",
      "required": true,
      "defaultValue": null
    }
  ],
  "output_schema": [
    {
      "name": "Company Website",
      "description": "Main website URL of the company",
      "display_column": "Company Website"
    }
  ],
  "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"
}