app.ai_usage
TableRow level security on
Aurora AI metering (ADR 0020): one row per authorized request. The monthly allowance aurora_requests_per_month counts these rows by metered_at in UTC months. Token counts arrive when the request completes. Kept for billing after request content is purged.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.ai_requests on insert; never accepted from the caller and never changed.References app.organizations.id |
| request_id | uuid | No | Request metered.References app.ai_requests.id |
| metered_at | timestamp with time zone | No | When the request was authorized and counted. |
| input_tokens | integer | Yes | Input tokens the model reported, or null until the request completes. |
| output_tokens | integer | Yes | Output tokens the model reported, or null until the request completes. |
| 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. |