app.integration_file_links
TableRow level security on
Provider files attached to XOS documents (Section 17 storage: document links and import). A Link keeps the provider's URL and metadata current; an Import also copies the file into the document through the scanned attachment pipeline whenever the provider version changes.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.integration_connections on insert; never accepted from the caller and never changed.References app.organizations.id |
| integration_connection_id | uuid | No | Storage connection the file lives in.References app.integration_connections.id |
| document_id | uuid | No | XOS document the file is attached to.References app.documents.id |
| link_mode | app.file_link_mode | No | Link or Import. |
| external_file_id | text | No | Provider file identifier. |
| file_name | text | No | File name as the provider reports it. |
| mime_type | text | Yes | MIME type as the provider reports it. |
| size_bytes | bigint | Yes | Size in bytes as the provider reports it. |
| web_url | text | Yes | HTTPS link that opens the file at the provider. |
| external_version | text | Yes | Provider revision, ETag or content hash last seen. |
| external_modified_at | timestamp with time zone | Yes | When the provider last changed the file. |
| attachment_id | uuid | Yes | Attachment on the document that imported versions belong to. Set by the runner.References app.attachments.id |
| last_attachment_version_id | uuid | Yes | Attachment version of the latest import, which becomes a document version once it scans Clean.References app.attachment_versions.id |
| imported_version | text | Yes | Provider revision of the latest import. |
| last_imported_at | timestamp with time zone | Yes | When the latest import was handed to scanning. |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |
| 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 |