LumenClip DocsData
Generation runs and outputs
Execution records, plans, results, slideshows, exports, and generated social drafts.
Generation runs and outputs
Every generated artifact enters the product as an output. A completed generation is draft until
the user publishes it immediately or assigns a future publish time. A post output can contain text
only or compose the media from a slideshow or video output.
Generation runs and outputs. Optionality and accepted values are included in each field description.
AutomationRunRecord
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Run ID. Accepted format: Stable domain ID. |
automationId | string | "record-123" | Required. Parent automation. Accepted format: Automation ID. |
automationTitle | string | "Example" | Required. Snapshot title. |
scheduledFor | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Content slot. Accepted format: ISO 8601. |
generationSource | string enum | "manual" | Optional. Initiator. Accepted format: manual, scheduled. |
requestId | string | "record-123" | Optional. Request identity. Accepted format: Idempotency/correlation ID. |
status | string enum | "running" | Required. Run lifecycle. Accepted format: running, succeeded, failed. |
postfastRecordId | string | "record-123" | Optional. Associated publication. Accepted format: Publication ID. |
slideshowId | string | "record-123" | Optional. Generated slideshow. Accepted format: Slideshow ID. |
videoUrl | string | "https://example.com/item" | Optional. Generated video. Accepted format: URL/path. |
thumbnailUrl | string | "https://example.com/item" | Optional. Preview image. Accepted format: URL/path. |
outputImages | string[] | [] | Optional. Rendered slides. Accepted format: URLs/paths. |
outputDir | string | "Example" | Optional. Render output location. Accepted format: Storage-relative path. |
socialStatuses | AutomationRunSocialStatus[] | [] | Optional. Per-target publication states. Accepted format: Array. |
manuallyPublishedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Manual publication evidence. Accepted format: ISO 8601. |
renderedSlides | AutomationRunRenderedSlide[] | [] | Optional. Rendered slide snapshot. Accepted format: Array. |
plan | AutomationRunPlan | "Example" | Required. Reproducible decisions. Accepted format: See below. |
createdAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updatedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
error | string | "Example" | Optional. Failure detail. |
AutomationRunPlan
| Field | Type | Example | Description |
|---|---|---|---|
title | string | "Example" | Required. Planned title. |
caption | string | "Example" | Required. Planned caption. |
hashtags | string | "Example" | Required. Planned hashtag text. |
hook | string | "Example" | Required. Resolved hook. |
hookId | string | "record-123" | Optional. Source hook. Accepted format: Hook ID. |
hookTemplate | string | "Example" | Optional. Pre-substitution hook. |
hookSubstitutions | object | { token: value } | Optional. Variable resolutions. Accepted format: { token: value }. |
imageCollectionIds | string[] | [] | Required. Used collections. Accepted format: Collection IDs. |
violations | string[] | [] | Optional. Policy/quality warnings. Accepted format: Free strings. |
slides | AutomationRunSlide[] | [] | Required. Planned slides. Accepted format: Array. |
slideCount | object | { mode, count?, min?, max? } | Required. Count decision. Accepted format: { mode, count?, min?, max? }. |
publishType | string | "Example" | Required. Output/publication form. Accepted format: Normalized publish type. |
autoMusic | boolean | true | Required. Music decision. Accepted format: true, false. |
autoPost | boolean | true | Required. Auto-publication decision. Accepted format: true, false. |
reuseWarnings | object[] | "kind" | Optional. Reuse exceptions. Accepted format: kind currently image. |
hookCandidates | string[] | [] | Optional. Candidate hooks. Accepted format: Free strings. |
textModel | string | "Example" | Optional. Text model used. Accepted format: Provider model ID. |
language | string | "Example" | Required. Generation language. Accepted format: Language label/code. |
translationProvider | string literal | "deepl" | Optional. Translation provider. Accepted format: deepl. |
contentStrategy | object | { "key": "value" } | Optional. Selected strategy route. Accepted format: Route ID, content format, CTA strategy. |
debug | object | { "key": "value" } | Optional. Generation diagnostics; not presentation data. Accepted format: Structured diagnostics. |
ResultRecord
| Field | Type | Example | Description |
|---|---|---|---|
ownerId | string | "record-123" | Optional. Output owner. Accepted format: Railway user ID. |
id | string | "record-123" | Required. Result ID. Accepted format: Stable domain ID. |
automationId | string | "record-123" | Required. Source automation. Accepted format: Automation ID. |
runId | string | "record-123" | Required. Source run; one current result per run. Accepted format: Run ID. |
workflowType | string enum | "slideshow" | Required. Result family. Accepted format: slideshow, video. |
title | string | "Example" | Required. Display title. |
status | string enum | "succeeded" | Required. Generation result. Accepted format: succeeded, failed. |
createdAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updatedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
artifacts | ResultArtifacts | "Example" | Required. Generated media. Accepted format: See below. |
payload | slideshow/video payload | "type" | Optional. Authoring/render payload. Accepted format: Discriminator type is slideshow or video. |
destinationAccountIds | string[] | [] | Required. Intended targets. Accepted format: Integration IDs. |
ResultArtifacts
| Field | Type | Example | Description |
|---|---|---|---|
slideshowId | string | "record-123" | Optional. Slideshow compatibility identity. Accepted format: Domain ID. |
videoUrl | string | "https://example.com/item" | Optional. Video output. Accepted format: URL/path. |
thumbnailUrl | string | "https://example.com/item" | Optional. Preview. Accepted format: URL/path. |
outputImages | string[] | [] | Required. Rendered image outputs. Accepted format: URLs/paths; may be empty. |
outputDir | string | "Example" | Optional. Render output directory. Accepted format: Storage-relative path. |
SlideshowRecord
| Field | Type | Example | Description |
|---|---|---|---|
ownerId | string | "record-123" | Optional. Owner. Accepted format: Railway user ID. |
id | string | "record-123" | Required. Slideshow ID. Accepted format: Domain ID. |
runId | string | "record-123" | Optional. Source run. Accepted format: Run ID. |
automationId | string | "record-123" | Optional. Source automation. Accepted format: Automation ID. |
title | string | "Example" | Required. Title. |
caption | string | "Example" | Required. Caption. |
hashtags | string | "Example" | Required. Hashtag text. |
prompt | string | "Example" | Required. Generation prompt. |
image_collection | string | "Example" | Required. Primary source collection. Accepted format: Collection ID. |
slideshow_type | string | "Example" | Required. Slideshow subtype. Accepted format: Free/normalized string. |
created_at | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updated_at | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
settings | SlideshowSettings | "Example" | Required. Global render settings. Accepted format: See below. |
images | SlideshowSlide[] | [] | Required. Slides. Accepted format: Array. |
status | string enum | "exported" | Required. Render status. Accepted format: exported, failed. |
output_dir | string | "Example" | Optional. Render directory. Accepted format: Storage-relative path. |
output_images | string[] | [] | Required. Rendered slides. Accepted format: URLs/paths. |
video_url | string | "https://example.com/item" | Optional. Rendered video. Accepted format: URL/path. |
thumbnail_url | string | "https://example.com/item" | Optional. Preview image. Accepted format: URL/path. |
SlideshowSettings
| Field | Type | Example | Description |
|---|---|---|---|
duration | number | 1 | Required. Slide duration. Accepted format: Positive seconds. |
aspect_ratio | string | "Example" | Required. Global ratio. Accepted format: Normally automation aspect-ratio enum. |
font | string | "Example" | Required. Global font. Accepted format: Font family. |
background_color | string | "#6d28d9" | Required. Canvas background. Accepted format: CSS color. |
transition_style | string | "Example" | Required. Transition. Accepted format: Registered transition. |
export_as_video | boolean | true | Required. Video render toggle. Accepted format: true, false. |
sound_id | string | "record-123" | Required. Sound ID. Accepted format: Provider ID or empty string. |
sound_name | string | "Example" | Required. Sound name. |
sound_url | string | "https://example.com/item" | Required. Sound source. Accepted format: URL or empty string. |
GeneratedVideoExport
| Field | Type | Example | Description |
|---|---|---|---|
ownerId | string | "record-123" | Optional. Owner. Accepted format: Railway user ID. |
id | string | "record-123" | Required. Export ID. Accepted format: Stable domain ID. |
type | string enum | "greenscreen" | Required. Export family. Accepted format: greenscreen, ugc_ad, template_video. |
status | string enum | "queued" | Required. Generation lifecycle. Accepted format: queued, processing, ready, failed. |
createdAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updatedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
title | string | "Example" | Required. Title. |
description | string | "Example" | Required. Description/copy. |
hashtags | string[] | [] | Required. Hashtags. Accepted format: Array. |
sourceConfig | object | { "key": "value" } | Required. Generator-specific inputs. Accepted format: JSON object. |
sourceAutomationId | string | "record-123" | Optional. Originating automation. Accepted format: Automation ID. |
sourceRunId | string | "record-123" | Optional. Originating run. Accepted format: Run ID. |
publication | object | { "key": "value" } | Optional. Publication summary. Accepted format: JSON object. |
queuePosition | number | 1 | Optional. Approximate queue position. Accepted format: Non-negative integer; only pending records. |
previewUrl | string | "https://example.com/item" | Optional. Preview. Accepted format: URL/path. |
videoUrl | string | "https://example.com/item" | Optional. Final video. Accepted format: URL/path. |
error | string | "Example" | Optional. Failure detail. |
manuallyPublishedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Manual publication evidence. Accepted format: ISO 8601. |
deletionBlockedBy | string enum | "published" | Optional. Why deletion is blocked. Accepted format: published, scheduled. |
XAutomationRun
| Field | Type | Example | Description |
|---|---|---|---|
id | string | "record-123" | Required. Run ID. Accepted format: Stable domain ID. |
ownerId | string | "record-123" | Optional. Owner. Accepted format: Railway user ID. |
requestId | string | "record-123" | Optional. Request identity. Accepted format: Correlation/idempotency ID. |
automationId | string | "record-123" | Required. Parent. Accepted format: Automation ID. |
automationName | string | "Example" | Required. Snapshot name. |
topic | string | "Example" | Required. Topic. |
archetype | string enum | "Example" | Optional. Selected archetype. Accepted format: X archetypes listed above. |
inferredBrief | object | "XInferredContentBrief" | Optional. Run-specific inferred brief. Accepted format: XInferredContentBrief. |
contentType | string enum | "single" | Required. Output form. Accepted format: single, thread, article. |
platform | string enum | "x" | Required. Target. Accepted format: x, threads. |
reactionMode | string enum | "none" | Required. Reaction behavior. Accepted format: none, repost, quote. |
sourceCandidate | object | "XTrendCandidate" | Optional. Discovered source. Accepted format: XTrendCandidate. |
hook | string | "Example" | Required. Hook stage. |
setup | string | "Example" | Required. Setup stage. |
content | string[] | [] | Required. Content stages. Accepted format: Array. |
proof | string | "Example" | Required. Proof stage. |
curiosityGap | string | "Example" | Required. Curiosity stage. |
cta | string | "Example" | Required. CTA stage. |
posts | XGeneratedPost[] | "hook" | Required. Final post units. Accepted format: Roles hook, setup, content, proof, gap, cta. |
articleTitle | string | "Example" | Optional. Article title. |
articleBody | string | "Example" | Optional. Article body. |
imagePrompt | string | "Example" | Optional. Generated-image prompt. |
imageUrls | string[] | "https://example.com/item" | Required. Generated media. Accepted format: URLs/paths. |
benchmark | object | "XAutomationBenchmarkScore" | Required. Quality score/evaluation. Accepted format: XAutomationBenchmarkScore. |
status | string enum | "draft" | Required. Run/content lifecycle. Accepted format: draft, approved, scheduled, published, failed. |
scheduledFor | ISO datetime | "2026-08-01T09:00:00.000Z" | Optional. Publication time. Accepted format: ISO 8601. |
createdAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Creation time. Accepted format: ISO 8601. |
updatedAt | ISO datetime | "2026-08-01T09:00:00.000Z" | Required. Last update. Accepted format: ISO 8601. |
error | string | "Example" | Optional. Failure detail. |
publishing | object | { "key": "value" } | Optional. Publication receipt. Accepted format: Attempt time, published/failed counts, optional skip reason. |
plans | object[] | [] | Optional. Multi-plan trace. Accepted format: Platform, archetype, pillar, hook style, review flag. |
needsReview | boolean | true | Optional. Review gate. Accepted format: true, false. |
reviewErrors | string[] | [] | Optional. Review failures. Accepted format: Array. |