app.automations
TableRow level security on
Automations (Section 7.3, Section 4.5.6 item 20, ADR 0047): when a domain event of the trigger type happens in the org and the conditions hold, the actions run as the owner through the public API. Written only through app.save_automation and its sibling RPCs; readable by holders of org.automations.write.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| name | text | No | Name shown in Settings, Automations. |
| description | text | Yes | What the automation is for. |
| trigger_event_type | text | No | Domain event type that starts a run, from the event catalog webhooks use (private.domain_event_types).References private.domain_event_types.code |
| condition_match | app.automation_match | No | all when every top-level condition must hold, any when one is enough. |
| owner_person_id | uuid | No | Person the actions run as: whoever last changed what the automation does or turned it on.References app.people.id |
| enabled | boolean | No | True while new events start runs. |
| paused_at | timestamp with time zone | Yes | When the engine turned the automation off because a run could not act as the owner (fail closed); null otherwise. |
| pause_reason | text | Yes | Why the engine paused it, a rule code such as owner_left_org, owner_lost_capability or owner_access_refused. |
| failure_notified_at | timestamp with time zone | Yes | When the owner was last told a run failed, so failures notify at most once an hour. |
| 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. |