app.usage_events
TablePartitioned by monthRow level security on
Metered usage (Section 16), one row per counted act, in monthly partitions. Written by the database and platform services only.
Primary key: id, created_at
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Usage event id, UUID v7. |
| org_id | uuid | No | Owning org. A row never moves to another org.References app.organizations.id |
| meter_code | text | No | What was used.References private.usage_meters.code |
| quantity | bigint | No | How much, in the meter's unit. |
| source_id | uuid | Yes | Row that caused the usage, when there is one (a notification delivery, an AI request). |
| 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. |