app.automation_run_steps
TableRow level security on
One action of an automation run (ADR 0047): the public API operation called as the owner, what was sent and answered, and how long it took. A retried run rewrites the step of the action that failed; finished steps are not run again.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.automation_runs on insert; never accepted from the caller and never changed.References app.organizations.id |
| automation_run_id | uuid | No | Run the step belongs to.References app.automation_runs.id |
| automation_action_id | uuid | Yes | Action the step ran, as it was defined when the run started.References app.automation_actions.id |
| position | smallint | No | Position of the action in the automation, 1 first. |
| action_type | app.automation_action_type | No | What the action does. |
| operation_id | text | Yes | Public API operation called, such as records.create. |
| step_status | app.automation_step_status | No | Succeeded, Failed or Skipped. |
| request_body | jsonb | Yes | Body sent to the operation, with templates filled in from the event: a provider payload (ADR 0002). |
| response_body | jsonb | Yes | Answer of the operation, trimmed to its identifying fields or the problem it reported: a provider payload. |
| http_status | smallint | Yes | HTTP status the API answered; null when no answer arrived. |
| error_code | text | Yes | Rule code of the failure, such as the API refusal rule. |
| error_message | text | Yes | Why the step failed, in words. |
| started_at | timestamp with time zone | No | When the step started. |
| finished_at | timestamp with time zone | No | When the step ended. |
| duration_ms | integer | No | Milliseconds the step took. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |