LumenClip Docs
LumenClip Docs
LumenClip engineering documentation
Data dictionaryPersistence and physical recordsWorkspace, collections, and assetsTemplate definitionsGeneration runs and outputsPublishing, calendar, and analyticsOperations and accessBackend architectureRailway runtimeBackend endpoints
Data

Persistence and physical records

Railway tables and serialized row envelopes used by the application.

Persistence and physical records

These are physical storage records and query projections. Domain-object pages document the serialized objects stored inside their data fields.

Persistence and physical records. Optionality and accepted values are included in each field description.

permanent_assets

FieldTypeExampleDescription
ridstring (1024)"record-123"Optional. Stable logical record ID. Accepted format: Domain identifier.
owner_idstring (36)"record-123"Optional. Omitted only for public reference rows. Accepted format: Railway user ID.
source_keystring (255)"Example"Optional. Polymorphic record discriminator. Accepted format: Values listed above.
namestring (2048)"Example"Optional. Projected label/title.
statusstring (255)"source_key"Optional. Projected lifecycle state. Accepted format: Depends on source_key.
created_rawstring (64)"2026-08-01T09:00:00.000Z"Optional. Projected domain creation time. Accepted format: ISO datetime.
datalong text{ "key": "value" }Optional. Complete serialized domain object. Accepted format: JSON object string.
ordinteger1Optional. Stable list order. Accepted format: Zero-based integer.
visibilitystring (32)"Example"Optional. Projected visibility.
asset_typestring (255)"Example"Optional. Broad asset subtype.
kindstring (255)"image"Optional. Media kind. Accepted format: Usually image, video, audio, or text.
parent_idstring (255)"record-123"Optional. Owning collection or parent asset. Accepted format: Domain ID.
descriptionmedium text"Example"Optional. Projected description.
textmedium text"Example"Optional. Searchable body text.
tagslong text["example"]Optional. Search/filter tags. Accepted format: JSON string array.
storage_bucketstring (255)"Example"Optional. Stored file bucket. Accepted format: Railway bucket ID.
storage_file_idstring (255)"record-123"Optional. Stored file identifier. Accepted format: Railway file ID.
storage_pathmedium text"assets/example.png"Optional. Compatibility asset path. Accepted format: Data-relative path.
urlmedium text"https://example.com/item"Optional. Application-facing media URL. Accepted format: URL/path.
mime_typestring (255)"Example"Optional. Stored media content type. Accepted format: MIME type.
bytesinteger1Optional. File size in bytes. Accepted format: Non-negative integer.
widthinteger1Optional. Pixel width when known. Accepted format: Positive integer.
heightinteger1Optional. Pixel height when known. Accepted format: Positive integer.
duration_msinteger1Optional. Audio/video duration. Accepted format: Non-negative integer.
checksumstring (255)"Example"Optional. Content identity/integrity digest. Accepted format: Digest string.
source_urlmedium text"https://example.com/item"Optional. Original import source. Accepted format: URL.
positioninteger1Optional. Position inside a parent. Accepted format: Zero-based integer.
updated_atstring (64)"2026-08-01T09:00:00.000Z"Optional. Projected update time. Accepted format: ISO datetime.
migration_sourcestring (255)"Example"Optional. Legacy migration provenance.

outputs

FieldTypeExampleDescription
ridstring (1024)"record-123"Optional. Stable logical output ID. Accepted format: Domain identifier.
owner_idstring (36)"record-123"Optional. Output owner. Accepted format: Railway user ID.
source_keystring (255)"result"Optional. Output discriminator. Accepted format: result, generated_video, x_automation_run, publication_wrapper.
namestring (2048)"Example"Optional. Projected output name.
statusstring (255)"source_key"Optional. Generation/content lifecycle. Accepted format: Depends on source_key.
created_rawstring (64)"2026-08-01T09:00:00.000Z"Optional. Domain creation time. Accepted format: ISO datetime.
datalong text{ "key": "value" }Optional. Complete output object. Accepted format: JSON object string.
ordinteger1Optional. Stable order. Accepted format: Zero-based integer.
kindstring (255)"Example"Optional. Broad content/media kind.
subtypestring (255)"Example"Optional. More specific output class.
storage_classstring (64)"Example"Optional. Storage policy/category.
originstring (64)"Example"Optional. How the output was created.
titlestring (2048)"Example"Optional. Display title.
hookmedium text"Example"Optional. Generated hook.
captionmedium text"Example"Optional. Generated/social caption.
hashtagslong text["example"]Optional. Hashtag payload. Accepted format: String or JSON string array.
textmedium text"Example"Optional. Primary generated text.
text_datalong text{ "key": "value" }Optional. Structured generated text. Accepted format: JSON string.
source_automation_idstring (255)"record-123"Optional. Originating automation. Accepted format: Domain ID.
source_run_idstring (255)"record-123"Optional. Originating run. Accepted format: Domain ID.
source_entity_idstring (255)"record-123"Optional. Originating slideshow/content entity. Accepted format: Domain ID.
has_videobooleantrueOptional. Fast video-output filter. Accepted format: true or false.
publication_statusstring (64)"Example"Optional. Projected primary publication state. Accepted format: Post status values below.
scheduled_atstring (64)"2026-08-01T09:00:00.000Z"Optional. Projected scheduled time. Accepted format: ISO datetime.
published_atstring (64)"2026-08-01T09:00:00.000Z"Optional. Projected publication time. Accepted format: ISO datetime.
primary_post_idstring (255)"record-123"Optional. Primary remote post. Accepted format: Provider post ID.
primary_release_urlmedium text"https://example.com/item"Optional. Primary published URL. Accepted format: URL.
publicationslong text"PostFastPostRecord[]"Optional. All publication attempts/records. Accepted format: JSON PostFastPostRecord[].
evaluationlong text{ "key": "value" }Optional. Quality/evaluation payload. Accepted format: JSON object string.
errormedium text"Example"Optional. Output-level failure detail.
updated_atstring (64)"2026-08-01T09:00:00.000Z"Optional. Domain update time. Accepted format: ISO datetime.
migration_sourcestring (255)"Example"Optional. Legacy migration provenance.

output_media

FieldTypeExampleDescription
output_idstring (36)"record-123"Optional. Parent output. Accepted format: Railway output row ID.
owner_idstring (36)"record-123"Optional. Parent owner. Accepted format: Railway user ID.
permanent_asset_idstring (36)"record-123"Optional. Reused permanent asset, if any. Accepted format: Railway row ID.
kindstring (64)"image"Optional. Media kind. Accepted format: image, video, audio, text.
rolestring (255)"Example"Optional. Thumbnail, source, result, slide, etc.
positioninteger1Optional. Order within the output. Accepted format: Zero-based integer.
storage_bucketstring (255)"Example"Optional. Stored file bucket. Accepted format: Railway bucket ID.
storage_file_idstring (255)"record-123"Optional. Stored file identifier. Accepted format: Railway file ID.
storage_pathmedium text"assets/example.png"Optional. Compatibility path. Accepted format: Data-relative path.
urlmedium text"https://example.com/item"Optional. Application-facing media URL. Accepted format: URL/path.
mime_typestring (255)"Example"Optional. Content type. Accepted format: MIME type.
bytesinteger1Optional. File size. Accepted format: Non-negative integer.
widthinteger1Optional. Pixel width. Accepted format: Positive integer.
heightinteger1Optional. Pixel height. Accepted format: Positive integer.
duration_msinteger1Optional. Audio/video duration. Accepted format: Non-negative integer.
checksumstring (255)"Example"Optional. Content digest. Accepted format: Digest string.
datalong text{ "key": "value" }Optional. Extra media metadata. Accepted format: JSON object string.
created_atstring (64)"2026-08-01T09:00:00.000Z"Optional. Creation time. Accepted format: ISO datetime.

Dedicated JSON-store row

FieldTypeExampleDescription
ridstring"record-123"Optional. Logical record ID. Accepted format: Domain identifier.
owner_idstring"record-123"Optional. Record owner. Accepted format: Railway user ID.
namestring"Example"Optional. Projected label.
statusstring"Example"Optional. Projected status. Accepted format: Domain lifecycle enum.
created_rawstring"2026-08-01T09:00:00.000Z"Optional. Projected creation time. Accepted format: ISO datetime.
ordinteger1Optional. Stable order. Accepted format: Zero-based integer.
datatext/long text{ "key": "value" }Requiredness: Yes in current dedicated stores. Complete domain object. Accepted format: JSON object string.

jobs

FieldTypeExampleDescription
typestring"Example"Optional. Dispatch key. Accepted format: Registered worker job type.
statusstring"queued"Optional. Queue lifecycle. Accepted format: queued, processing, completed, failed, dead.
priorityinteger0Optional. Higher-priority work is claimed first. Accepted format: Integer; default 0 in app enqueue path.
priority_rawstring"Example"Optional. Compatibility projection. Accepted format: Legacy numeric string.
available_atstring"2026-08-01T09:00:00.000Z"Optional. Earliest claim time. Accepted format: ISO datetime.
leased_bystring"Example"Optional. Current claimant. Accepted format: Worker ID.
leased_untilstring"2026-08-01T09:00:00.000Z"Optional. Claim expiry. Accepted format: ISO datetime.
attemptsinteger0Optional. Attempts already made. Accepted format: Non-negative integer; starts at 0.
max_attemptsinteger3Optional. Retry ceiling. Accepted format: Positive integer; default 3.
payloadlong text{ "key": "value" }Optional. Job input. Accepted format: JSON.
resultlong text{ "key": "value" }Optional. Completed output/receipt. Accepted format: JSON.
errorstring"Example"Optional. Last failure.
dedupe_keystring"Example"Optional. Duplicate-enqueue boundary. Accepted format: Owner-scoped stable key.
owner_idstring"record-123"Optional. Job owner. Accepted format: Railway user ID.
created_atstring"2026-08-01T09:00:00.000Z"Optional. Enqueue time. Accepted format: ISO datetime.
updated_atstring"2026-08-01T09:00:00.000Z"Optional. Last state transition. Accepted format: ISO datetime.

workspace_members

FieldTypeExampleDescription
owner_idstring"record-123"Required. Workspace owner. Accepted format: Railway user ID.
owner_namestring"Example"Required. Owner display name.
emailstring"editor@example.com"Required. Invited member. Accepted format: Normalized email.
member_user_idstring"record-123"Optional. Set after acceptance. Accepted format: Railway user ID.
statusstring"pending"Required. Invitation lifecycle. Accepted format: pending, accepted.
team_idstring"record-123"Required. Workspace team. Accepted format: Railway Team ID.
membership_idstring"record-123"Required. Team membership. Accepted format: Railway membership ID.
created_atstring"2026-08-01T09:00:00.000Z"Required. Invitation creation time. Accepted format: ISO datetime.

demos

FieldTypeExampleDescription
owner_idstring"record-123"Required. Demo owner. Accepted format: Railway user ID.
titlestring"Example"Required. Display title.
file_idstring"record-123"Required. File in the demos bucket. Accepted format: Railway file ID.
content_typestring"video/mp4"Required. Response content type. Accepted format: MIME type; fallback video/mp4.
created_atstring"2026-08-01T09:00:00.000Z"Required. Creation time. Accepted format: ISO datetime.

Data dictionary

Field-level data structures grouped by application domain.

Workspace, collections, and assets

Workspace runtime data and reusable media, image, word, product, and asset structures.

On this page

Persistence and physical records