Constant Schema Docs

Database models, scalar models, enums, and relations from ConstantRegistry.

Database Models
19
Scalar Models
23
Enums
55
Relations
79

Database Models

BoardPinboardPinsceny
Where one library asset sits on a project canvas.
BoardPinFull12 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
project
Video Project
ID!
propertyimmutable
—
—
—
Video project whose canvas the pin sits on
targetType
Target Type
String
propertyimmutable
—
—
videoCharactervideoScenevideoObjcreativefilevideoBoardgenImagevideoPlanvideoTake
Kind of asset the pin places
target
Target
ID
propertyimmutable
—
—
—
Asset the pin places on the canvas
text
Text
String
property
—
text:desc
—
Text of a memo pin. A pin with no target is a memo and carries only this.
name
Name
String
property
—
—
—
Card name of a generated picture, like Image 3. Empty on a picture drawn before names existed, which shows its prompt.
position
Position
[Int]!
property
[0,0]
—
—
Position of the pin on the canvas
memoStyle
Text Style
MemoStyle
property
—
—
—
Size, color, weight and slant of a memo pin's text. Empty reads as the plain style.
face
Face
BoardPinFace
resolve
—
—
—
Name and thumbnail read from the asset the pin points at
Creativecreativesceny
A creative record uploaded to the project canvas — an image, video, or audio file.
CreativeFull11 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
LightUser!reference
property
—
—
—
Owner of the creative
title
Title
String!
property
—
text:title
—
Title of the creative
tags
Tags
[String]!
property
[]
text:tag
—
Tags of the creative
file
File
File!reference
propertyimmutable
—
—
—
File of the creative
assetKind
Kind
String
property
—
—
originalclone
Original in the library, or a clone made when assigned to a board. Empty means original
copyOf
Clone Of
ID
property
—
—
—
The original creative this clone was made from
type
Type
String!
property
—
—
photovideoaudio
Type of the creative
CreditLogcreditLogsceny
One change to a user's credit balance: an admin grant or deduction, a generation charge, or its refund.
CreditLogFull20 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
user
User
LightUser!reference
propertyimmutable
—
—
—
Whose balance moved
type
Type
String!
property
—
—
grantdeductuserefund
Grant and deduct are an admin's hand; use is a generation charge; refund returns a failed one
amount
Amount
Int!
property
—
—
—
Credits added to the balance - negative for a deduction or a charge
note
Note
String
property
—
—
Why an admin moved the balance
status
Status
String!
property
settled
—
pendingsettledrefunded
A charge stays pending until its generation completes (settled) or fails (refunded)
admin
Admin
ID
property
—
—
—
Admin who granted or deducted
genImage
Image Generation
ID
property
—
—
—
The image generation charged
genVideo
Video Generation
ID
property
—
—
—
The video generation charged
videoInspect
Reference Analysis
ID
property
—
—
—
The reference video analysis charged
job
Job
String
property
—
—
videoimageregeneratecharactersceneobjinspect
What the charge paid for: a video, a picture, a picture drawn again, an asset sheet or an analysis
model
Model
String
property
—
—
—
Generation model the charge was priced by
resolution
Resolution
String
property
—
—
—
Resolution tier the charge was priced at
seconds
Seconds
Int
property
—
—
—
Length of the video charged
sourceSeconds
Source Seconds
Int
property
—
—
—
Length of the source video an edit read, charged on top of the video it made
imageNum
Images
Int
property
—
—
—
Number of images charged
aspectRatio
Aspect Ratio
String
property
—
—
9:1616:91:14:5
Ratio of the video charged
Settingsettingsceny (extends genai, shared)
Application-wide configuration for the Sceny domain.
SettingFull31 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
resignupDays
Re-signup Days
Int!
property
0
—
—
The number of days to allow re-signup
globalImagePrompt
Global Image Prompt
String
property
—
—
Prepended to every image request, before any style prompt.
globalVideoPrompt
Global Video Prompt
String
property
—
—
Prepended to every video request, before any style prompt.
imagePostPrompt
Image Closing Rule
String
property
—
—
The last sentence of every cut prompt — the one that keeps text out of the frame.
videoPostPrompt
Video Closing Rule
String
property
—
—
The last sentence of every shot prompt — the one that keeps captions and lip-sync out.
imageNegativePrompt
Image Negative Prompt
String
property
—
—
Comma-separated terms every cut image avoids — anatomy, identity drift, quality. Text and watermarks belong to the closing rule instead.
videoNegativePrompt
Video Negative Prompt
String
property
—
—
Comma-separated terms every shot avoids. Sent as the vendor's own negative field where the model has one, and as the prompt's last line where it does not.
agentSummaryPrompt
Conversation Summary Prompt
String
property
—
—
System prompt of the summarizer that compacts a long conversation.
imageRefinePrompt
Image Refine Prompt
String
property
—
—
System prompt of the refiner that rewrites a cut's fragments into one English instruction.
videoRefinePrompt
Video Refine Prompt
String
property
—
—
System prompt of the refiner that rewrites a shot's fragments into one English instruction.
assetRefinePrompt
Asset Refine Prompt
String
property
—
—
System prompt of the refiner that rewrites an asset sheet's fragments into one English description of that one subject.
mediumImagePrompt
Medium Image Prompt
Map<String, String>!
property
{}
—
—
Image style sentence per medium. Blank falls back to the built-in default.
mediumVideoPrompt
Medium Video Prompt
Map<String, String>!
property
{}
—
—
Video style sentence per medium. Blank falls back to the built-in default.
draftAgentPrompt
New Project Agent Prompt
String
property
—
—
The agent of the 'new video project' screen. Its one job is to create the project.
videoBoardAgentPrompt
Plan Agent Prompt
String
property
—
—
Instructions for the assistant on the plan screen
videoBoardRefinePrompt
Plan Refine Prompt
String
property
—
—
How the plan's Korean beats are rewritten into English shot-craft, one line per beat
adminAgentPrompt
Admin Console Agent Prompt
String
property
—
—
The agent of this console.
personPolicyPrompt
People Policy
String
property
—
—
What may appear in frame in every video of this workspace. Outranks any reference ad.
inspirationPerceivePrompt
Catalog Reading Prompt
String
property
—
—
How the video reader logs a catalog ad: shots, elements, beats and keyframe candidates. It never sees the research labels.
inspirationComposePrompt
Catalog Composing Prompt
String
property
—
—
How the log and the research labels become a catalog entry: element notes, keyframes, roles, beats and guide
inspirationReadModel
Catalog Reading Model
String
property
—
—
Gemini model id that watches the YouTube link
inspirationComposeModel
Catalog Composing Model
String
property
—
—
LLM model id that writes the catalog entry
inspirationPickPrompt
Reference Ad Pick Prompt
String
property
—
—
How the reference screen searches the published catalog and picks the one ad a video follows, from the product photos and the user's words
inspirationPlanPrompt
Reference Video Plan Prompt
String
property
—
—
How the reference screen writes a plan from the picked catalog ad and the product photos before it renders the video
characterSheetPrompt
Character Sheet Layout
String
property
—
—
The four-panel turnaround and lighting every character sheet is drawn in. The medium's finish sentence is appended after it.
characterRefPrompt
Character Reference Photo Rule
String
property
—
—
What a character sheet takes from its attached photos. A line counting the photos goes before it, and it is left out when there are none.
characterPortraitPrompt
Character Portrait Prompt
String
property
—
—
How the card's head-and-shoulders portrait is drawn from a finished sheet
Summarysummarysceny (extends genai, shared)
Aggregated dashboard statistics for the Sceny domain.
SummaryFull48 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
type
Type
String!
property
non-periodic
—
non-periodicactivehourlydailyweeklymonthly
Type of summary, e.g. periodic, non-periodic...
at
At
Date!
property
[function]
—
—
The time when the summary is created
status
Status
String!
property
archived
—
activearchived
Status of the summary
prepareUser
Prepare User
Int!
property
0
—
—
Number of users with preparation
activeUser
Active User
Int!
property
0
—
—
Number of active users
dormantUser
Dormant User
Int!
property
0
—
—
Number of dormant users
restrictedUser
Restricted User
Int!
property
0
—
—
Number of users with restrictions
hau
HAU
Int!
property
0
—
—
Hourly Active User
dau
DAU
Int!
property
0
—
—
Daily Active User
wau
WAU
Int!
property
0
—
—
Weekly Active User
mau
MAU
Int!
property
0
—
—
Monthly Active User
totalGenImage
Total Images
Int!
property
0
—
—
Every image generation request on record
pendingGenImage
Pending Images
Int!
property
0
—
—
Accepted, not handed to a provider yet
generatingGenImage
Generating Images
Int!
property
0
—
—
Waiting on the provider right now
completedGenImage
Completed Images
Int!
property
0
—
—
Finished with at least one image
failedGenImage
Failed Images
Int!
property
0
—
—
Given up on — the provider errored, or the request was left unfinished
dailyGenImage
Images (24h)
Int!
property
0
—
—
Created in the last 24 hours
totalGenVideo
Total Videos
Int!
property
0
—
—
Every video generation request on record
pendingGenVideo
Pending Videos
Int!
property
0
—
—
Accepted, not handed to a provider yet
generatingGenVideo
Generating Videos
Int!
property
0
—
—
Waiting on the provider right now
completedGenVideo
Completed Videos
Int!
property
0
—
—
Finished with a video in hand
failedGenVideo
Failed Videos
Int!
property
0
—
—
Given up on — the provider errored, or the request was left unfinished
dailyGenVideo
Videos (24h)
Int!
property
0
—
—
Created in the last 24 hours
totalSessionChat
Total Messages
Int!
property
0
—
—
Every message stored across all agent sessions
userSessionChat
User Messages
Int!
property
0
—
—
Messages a person sent
assistantSessionChat
Assistant Messages
Int!
property
0
—
—
Messages the agent sent back
dailySessionChat
Messages (24h)
Int!
property
0
—
—
Created in the last 24 hours
totalAgentSession
Total Sessions
Int!
property
0
—
—
Every agent conversation on record
idleAgentSession
Idle Sessions
Int!
property
0
—
—
No turn in flight
thinkingAgentSession
Thinking Sessions
Int!
property
0
—
—
The agent is thinking
awaitingAgentSession
Awaiting Sessions
Int!
property
0
—
—
Paused on a question — it is the user's turn
editingAgentSession
Editing Sessions
Int!
property
0
—
—
The agent is producing output
failedAgentSession
Failed Sessions
Int!
property
0
—
—
The last turn failed
dailyAgentSession
Sessions (24h)
Int!
property
0
—
—
Created in the last 24 hours
totalVideoProject
Total Projects
Int!
property
0
—
—
Every project on record
dailyVideoProject
Projects (24h)
Int!
property
0
—
—
Created in the last 24 hours
totalVideoBoard
Total Plans
Int!
property
0
—
—
Plans across every project
totalVideoScene
Total Scenes
Int!
property
0
—
—
Reusable scene assets
totalVideoCharacter
Total Characters
Int!
property
0
—
—
Reusable character assets
totalVideoObj
Total Objects
Int!
property
0
—
—
Reusable object assets
totalCreative
Total Creatives
Int!
property
0
—
—
Every file in the user libraries
photoCreative
Photo Creatives
Int!
property
0
—
—
Library files that are photos
videoCreative
Video Creatives
Int!
property
0
—
—
Library files that are videos
audioCreative
Audio Creatives
Int!
property
0
—
—
Library files that are audio
Userusersceny (extends shared)
User is an public information of the user who uses the service. It can be displayed to other users.
UserFull32 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
nickname
Nickname
String
property
maxlength 20text:title
—
Nickname of the user that is displayed to other users
image
Image
Filereference
property
—
text:thumb
—
Profile image of the user
images
Images
[File]!reference
property
[]
—
—
Profile images of the user
appliedImages
Applied Images
[File]!reference
property
[]
—
—
Applied images of the user
name
Name
String
secretselect:false
—
—
—
Name of the user
agreePolicies
Agree Policies
[String]
secretselect:false
[]
—
—
Agreed policies of the user
discord
Discord
Any
secretselect:false
{}
—
—
Discord information of the user
accountId
Account ID
String
secretselect:false
—
—
—
Account ID of the user
password
Password
String
secretselect:false
—
—
—
Password of the user
phone
Phone
String
secretselect:false
—
—
—
Phone number of the user
notiInfo
Noti Info
NotiInfo
secretselect:false
[function]
—
—
Notification information of the user
imageNum
Image Number
Int
secretselect:false
0
—
—
Number of images of the user
encourageInfo
Encourage Info
EncourageInfo
secretselect:false
[function]
—
—
Encourage information of the user
restrictInfo
Restrict Info
RestrictInfo
secretselect:false
—
—
—
Restrict information of the user
leaveInfo
Leave Info
LeaveInfo
secretselect:false
—
—
—
Leave information of the user
verifies
Verifies
[String]!
property
[]
—
naverkakaogithubgoogleapplefacebookwalletpasswordphoneemail
Verification information of the user
verifiedEmails
Verified Emails
[String]
secretselect:false
[]
—
—
Email addresses the user proved after signing up, besides the account ID
roles
Roles
[String]!
property
["user"]
text:filter
rootadminuserbusinessguest
Authorized roles of the user
playing
Playing
[String]!
property
[]
—
—
Services that the user is playing
isOnline
Is Online
Boolean!
property
true
—
—
Online status of the user
lastLoginAt
Last Login At
Date!
property
[function]
—
—
Latest login time of the user
joinAt
Join At
Date
property
—
—
—
Join date of the user
profileStatus
Profile Status
String!
property
prepare
text:filter
activeprepareappliedapprovedreappliedfeaturedreservedrejected
Profile approval status of the user
badgeCount
Badge Count
Int!
property
0
—
—
Badge count of the user
status
Status
String!
property
prepare
text:filter
prepareactivedormantrestricted
Status of the user
credit
Credit
Int!
property
0
—
—
Balance spent on image and video generation. Only an admin grant or deduction, a generation or its refund moves it.
theme
Theme
String
property
—
—
systemlightdark
The screen theme the person picked. Empty until they pick one, and until then each device keeps its own theme. System follows each device's own setting.
language
Language
String
property
—
—
enko
The language the person picked. Empty until they pick one, and until then each browser's language decides.
VideoBoardvideoBoardsceny
One video board makes one video: the plan and assets copied onto it and its spec. Each render becomes a video of its own.
VideoBoardFull27 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
ID!
propertyimmutable
—
—
—
Who made this video board
project
Project
ID!
propertyimmutable
—
—
—
Project the video board belongs to. Its title and description ride every render
name
Name
String
property
—
—
The board's own name, shown on its card. Putting a plan in, swapping it or editing it never changes it.
plan
Plan
LightVideoPlanreference
property
—
—
—
The plan clone made when a plan was assigned to this board. Editing the original later leaves it as it is; editing the clone changes this board only.
refAssets
Board Assets
[RefAsset]!
property
[]
—
—
Asset clones on this board, each with the @slot it plays; one without a relation rides as a reference picture.
mediaStyle
Media Style
MediaStyle
property
—
—
—
The look every render of this video board starts from: its medium and keywords. Empty leaves the look to the defaults.
videoStyle
Video Style
VideoStyle
property
—
—
—
Pace and reference prompt of this video board. Empty leaves them to the defaults.
refImages
References
[File]!reference
property
[]
—
—
Reference images attached by hand, at most four
startFrame
Opening Frame
Filereference
property
—
—
—
The frame the video opens on. Pinning it narrows which models can render the plan.
endFrame
Closing Frame
Filereference
property
—
—
—
The frame the video closes on. It needs an opening frame, and narrows the models further.
videoGenModel
Video Model
String
property
—
—
dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-4.0kling-v3kling-v3-omnigemini-omni-1.1-flashveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit
Leave it empty - the spec picks the model, and pinning one can leave no model able to render it
resolution
Resolution
String
property
—
—
480p720p1080p
480p, 720p or 1080p. Empty renders at each model's usual tier and is priced as 720p; 1080p costs twice 720p.
aspectRatio
Aspect Ratio
String!
property
9:16
—
9:1616:91:14:5
Aspect ratio of the video, and of every reference drawn for it
durationSeconds
Length
Int!
property
15
—
—
How many seconds the video runs. Every cut of the plan gets an equal share of it.
audio
Audio
Boolean!
property
false
—
—
Whether the video carries vendor-generated sound. Turning on BGM, narration or sound effects turns it on
bgm
BGM
Boolean
property
—
—
—
Whether the video's sound carries background music
narration
Narration
Boolean
property
—
—
—
Whether the video's sound carries a narrator's voice-over
soundEffect
Sound Effects
Boolean
property
—
—
—
Whether the video's sound carries sound effects
refGenModel
Reference Model
String!
property
gemini-nano-banana-2.1
—
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
Leave it alone - the model is chosen for you
refGenImages
Generated References
[GenImage]!reference
property
[]
—
—
The references drawn from the cut table, one image each, oldest first
prevRefImages
Reference History
[GenImage]reference
secretselect:false
[]
—
—
Every reference this video board has drawn, oldest first
archived
Archived
Boolean!
property
false
—
—
Whether this video board was deleted into the archive, recoverable
assetFaces
Asset Faces
[BoardPinFace]!
resolve
[]
—
—
Name and thumbnail of each board asset copy, in the order of the board assets
VideoCharactervideoCharactersceny
A character asset sheet that keeps the same person consistent across cuts.
VideoCharacterFull29 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
LightUserreference
property
—
—
—
Owner of the character; empty for an official provided model, which belongs to no account
project
Project
ID
property
—
—
—
ID of the project the character belongs to. Empty for one made in the library or whose project was deleted
name
Name
String!
property
—
text:title
—
Name of the character
gender
Gender
String
property
—
—
malefemaleother
Gender of the character. Characters made before this field have none
medium
Medium
String
property
—
—
liveActionanimationillustrationthreeDmixed
The medium the sheet is drawn in. A sheet made from a board slot takes that board's medium; empty is live action
description
Prompt
String
property
text:desc
—
What the character looks like. Optional - the name and gender alone can draw a sheet
image
Image
Filereference
property
—
—
—
The character's own picture. A character that has one is used as it is and never drawn
refImages
Reference Images
[File]!reference
property
[]
—
—
Reference images the sheet is drawn from, at most two
voice
Audio
Filereference
property
—
—
—
An MP3, WAV or M4A file of the character's voice. It is only stored for now and does not go into any generation
age
Age
Int
property
—
—
—
Age in years. Empty means not decided, and the sheet leaves it to the prompt
height
Height
Int
property
—
—
—
Height in centimetres. Empty means not decided
build
Build
String
property
—
—
—
Body build of the character
hair
Hair
String
property
—
—
—
Hairstyle and hair colour of the character
outfit
Outfit
String
property
—
—
—
What the character wears
intro
One-line Intro
String
property
—
—
—
Who the character is, in at most 40 characters. It goes into the sheet and every cut that casts them
origin
Origin
String
property
—
—
userplansceny
Who made the character: the user, the agent for a plan role, or Sceny as a provided model
lastGenModel
Last Generation Model
String!
property
gemini-nano-banana-2.1
—
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
Image generation model used for the next reference image of the character
lastGenResolution
Resolution
String
property
1K
—
1K2K4K
Resolution tier the character's sheet is drawn at, repeated when it is drawn again. 2K and 4K cost more credits
assetKind
Kind
String
property
—
—
originalclone
Original in the library, or a clone made when assigned to a board. Empty means original
copyOf
Clone Of
ID
property
—
—
—
The original character this clone was made from
lastGenImage
Last Generation Image
GenImagereference
property
—
—
—
Image of the character generated by AI
genImages
Generated Images
[GenImage]reference
secretselect:false
[]
—
—
Images of the character in different poses and expressions generated by AI
refinedPrompt
Refined Prompt
String
property
—
—
The one English description the refiner wrote in place of this sheet's assembled fragments
refinedPromptKey
Refined Prompt Key
String
property
—
—
Fingerprint of the fragments that refinement was run on; a change re-runs it
favorite
Favorite
Boolean!
property
false
—
—
Starred in the library, so the favorites-only filter keeps it
VideoObjvideoObjsceny
An object asset sheet that keeps the same prop or product consistent across cuts.
VideoObjFull21 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
LightUser!reference
property
—
—
—
Owner of the object
project
Project
ID
property
—
—
—
ID of the project the object belongs to. Empty for one made in the library or whose project was deleted
name
Name
String!
property
—
text:title
—
Name of the object
description
Description
String
property
text:desc
—
Description of the object
productType
Product Type
String
property
text:tag
—
What kind of product this is, such as a canned drink or a skincare bottle
medium
Medium
String
property
—
—
liveActionanimationillustrationthreeDmixed
The medium the sheet is drawn in. A sheet made from a board slot takes that board's medium; empty is live action
image
Image
Filereference
property
—
—
—
The object's own picture. An object that has one is used as it is and never drawn
refImages
Reference Images
[File]!reference
property
[]
—
—
Reference images the sheet is drawn from, at most two
lastGenModel
Last Generation Model
String!
property
gemini-nano-banana-2.1
—
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
Image generation model used for the next reference image of the object
lastGenResolution
Resolution
String
property
1K
—
1K2K4K
Resolution tier the object's sheet is drawn at, repeated when it is drawn again. 2K and 4K cost more credits
assetKind
Kind
String
property
—
—
originalclone
Original in the library, or a clone made when assigned to a board. Empty means original
copyOf
Clone Of
ID
property
—
—
—
The original object this clone was made from
lastGenImage
Last Generation Image
GenImagereference
property
—
—
—
Image of the object generated by AI
genImages
Generated Images
[GenImage]reference
secretselect:false
[]
—
—
Images of the object in different poses and expressions
refinedPrompt
Refined Prompt
String
property
—
—
The one English description the refiner wrote in place of this sheet's assembled fragments
refinedPromptKey
Refined Prompt Key
String
property
—
—
Fingerprint of the fragments that refinement was run on; a change re-runs it
favorite
Favorite
Boolean!
property
false
—
—
Starred in the library, so the favorites-only filter keeps it
VideoPlanvideoPlansceny
One plan: the beats a video is divided into. Assigning it to a board copies it there.
VideoPlanFull15 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
ID!
propertyimmutable
—
—
—
Who wrote this plan
project
Project
ID!
propertyimmutable
—
—
—
Project the plan belongs to
phrase
Catchphrase
String
property
text:title
—
The one line this plan sells, and the name it is recognised by in a list
summary
Direction
String
property
text:desc
—
One paragraph of direction that governs every beat - the concept, the arc, what the camera never shows
cutFrames
Cuts
[CutFrame]!
property
[]
—
—
The beats this plan is divided into, in order. Write an asset as @slot; a board binds it by relation.
roles
Assets
[PlanRole]!
property
[]
—
—
One entry per @slot the beats write: what kind of asset plays it, what it looks like, and whether it is a real product that needs a photo
assetKind
Kind
String
property
—
—
originalclone
Original in the library, or a clone made when assigned to a board. Empty means original
copyOf
Clone Of
ID
property
—
—
—
The original plan this clone was made from
copiedFrom
Copied From
ID
property
—
—
—
The plan of another project this original was copied in from; copying that plan into this project again returns this one
favorite
Favorite
Boolean!
property
false
—
—
Starred in the library, so the favorites-only filter keeps it
savedAt
Registered At
Date
property
—
—
—
When the plan was registered as an asset; empty means it lives only on its project's canvas, not in the library
VideoProjectvideoProjectsceny
One video production workspace: a named folder holding the plans and the asset sheets they share.
VideoProjectFull11 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
User!reference
propertyimmutable
—
—
—
Owner of the project
name
Name
String!
property
—
text:title
—
Name of the project
description
Description
String
property
—
—
Description of the project
agentSession
Chat
ID
property
—
—
—
The conversation this project is carrying on
thumbnail
Thumbnail
Filereference
property
—
—
—
The canvas fitted whole, captured while it is open
lightThumbnail
Light Thumbnail
Filereference
property
—
—
—
The same capture under the light theme
untitled
Untitled
Boolean!
property
false
—
—
Still the placeholder name; the first plan on the canvas names the project
VideoScenevideoScenesceny
A background asset sheet that keeps the same space consistent across cuts.
VideoSceneFull20 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
LightUser!reference
property
—
—
—
Owner of the scene
project
Project
ID
property
—
—
—
ID of the project the scene belongs to. Empty for one made in the library or whose project was deleted
name
Name
String!
property
—
text:title
—
Name of the scene
description
Description
String
property
text:desc
—
Description of the scene
medium
Medium
String
property
—
—
liveActionanimationillustrationthreeDmixed
The medium the sheet is drawn in. A sheet made from a board slot takes that board's medium; empty is live action
image
Image
Filereference
property
—
—
—
The scene's own picture. A scene that has one is used as it is and never drawn
refImages
Reference Images
[File]!reference
property
[]
—
—
Reference images the sheet is drawn from, at most two
lastGenModel
Last Generation Model
String!
property
gemini-nano-banana-2.1
—
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
Image generation model used for the next reference image of the scene
lastGenResolution
Resolution
String
property
1K
—
1K2K4K
Resolution tier the scene's sheet is drawn at, repeated when it is drawn again. 2K and 4K cost more credits
assetKind
Kind
String
property
—
—
originalclone
Original in the library, or a clone made when assigned to a board. Empty means original
copyOf
Clone Of
ID
property
—
—
—
The original scene this clone was made from
lastGenImage
Last Generation Image
GenImagereference
property
—
—
—
Image of the scene generated by AI
genImages
Generated Images
[GenImage]reference
secretselect:false
[]
—
—
Images of the scene in different poses and expressions
refinedPrompt
Refined Prompt
String
property
—
—
The one English description the refiner wrote in place of this sheet's assembled fragments
refinedPromptKey
Refined Prompt Key
String
property
—
—
Fingerprint of the fragments that refinement was run on; a change re-runs it
favorite
Favorite
Boolean!
property
false
—
—
Starred in the library, so the favorites-only filter keeps it
VideoTakevideoTakesceny
One rendered video: the plan, assets and spec of its board as they stood when it was made, and the render itself.
VideoTakeFull17 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
owner
Owner
ID!
propertyimmutable
—
—
—
Who made this video
project
Project
ID
propertyimmutable
—
—
—
Project the video belongs to; empty for a video made on the reference screen
inspiration
Reference Ad
ID
propertyimmutable
—
—
—
The catalog ad a video made on the reference screen followed
sourceBoard
Board
ID
propertyimmutable
—
—
—
The board it was made from. It only points back: changing or deleting the board never changes the video.
plan
Plan
TakePlan!
propertyimmutable
—
—
—
The plan as it stood when the video was made
cast
Assets
[TakeCast]!
propertyimmutable
[]
—
—
Each board asset as it stood when the video was made: name, look and picture
spec
Spec
TakeSpec!
propertyimmutable
—
—
—
Ratio, length, audio, style, references, frames and model the video was made with
genVideo
Render
GenVideoreference
property
—
—
—
The vendor job and its file. Progress, failure and the credit charge all live on this record.
refinedBeats
Refined Beats
[String]!
property
[]
—
—
The beats rewritten into English shot-craft, one line per cut. Timecodes are attached separately.
refinedPromptKey
Refine Fingerprint
String
property
—
—
Fingerprint of the input the beats above were written from, so a regeneration reuses them only when nothing changed.
name
Name
String
property
—
—
A name given to the video on the canvas; empty shows the plan's catchphrase
projectName
Project Name
String
resolve
—
—
—
The current name of the project the video was made in; empty for a reference-screen video
inspirationTitle
Reference Ad Title
String
resolve
—
—
—
The current title of the catalog ad the video followed; empty for any other video
Adminadminshared
Admin is a person who manages the system, that has a data managent and system monitoring authority.
AdminFull8 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
accountId
Account ID
String!
property
—
text:titlecustom validate
—
Account ID Description
password
Password
String
secretselect:false
—
minlength 8
—
Password Description
roles
Roles
[String]!
property
[]
text:filter
viewermanageradminsuperAdmin
Roles Description
lastLoginAt
Last Login
Date!
property
[function]
—
—
Last Login Description
Filefileshared
File is a blob data that is stored in the database, such as image, document or video
FileFull15 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
filename
File Name
String!
property
—
text:title
—
Name of the file with extension
mimetype
Mime Type
String!
property
—
—
—
Mime type of the file
encoding
Encoding
String
hidden
—
—
—
Encoding of the file
imageSize
Image Size
[Int]!
property
[0,0]
—
—
Size of the image as width and height tuple in pixel
url
Url
String
property
—
—
Url of the file
abstractData
Abstract Data
String
property
—
—
—
Abstract blurred encoded data of image files to preview
size
Size
Int!
property
0
—
—
File size in bytes
origin
Origin
String
hidden
—
—
—
Origin source url of the file
lastModifiedAt
Last Modified At
Date!
property
[function]
—
—
Last modified date of the file
progress
Progress
Int
property
—
—
—
Upload progress of the file, uploading status files are used only
status
Status
String!
property
uploading
—
activeuploadingfailed
Status of the file
AgentSessionagentSessiongenai
Agentic chat session
AgentSessionFull17 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
user
User
ID!
propertyimmutable
—
—
—
User ID
title
Title
String
property
—
—
Session title from the first prompt
parent
Parent
ID!
propertyimmutable
—
—
—
Owning document
parentType
Parent Type
String!
propertyimmutable
—
—
—
Model name of the owning document
status
Status
String!
property
idle
—
idlethinkingawaitingeditingfailed
Turn lifecycle status
contextSummary
Context Summary
String
property
—
—
Rolling compaction of earlier turns injected as the agent's long-context memory
summarizedSeq
Summarized Seq
Int!
property
-1
—
—
Highest sessionChat seq already folded into the summary (−1 = none)
plan
Plan
[AgentPlanStep]!
property
[]
—
—
Steps the turn in flight intends to run, in order
planTurn
Plan Turn
Int!
property
0
—
—
Which turn the current plan belongs to, so a stale resume is refused
pendingQuestion
Pending Question
AgentQuestion
property
—
—
—
The question this turn suspended on, absent once answered
turnHeartbeatAt
Turn Heartbeat At
Date
hidden
—
—
—
When the process running the current turn last reported itself alive; a stale one means the turn died with it
chatSeq
Next Message Seq
Int
hidden
—
—
—
The seq the next transcript message takes; reserved atomically so two writers never share one
lastSyncBatchId
Last Saved Batch
String
hidden
—
—
—
The last transcript batch a screen saved, so a retried batch is stored once
GenImagegenImagegenai
An image generated from a prompt via an image generation provider.
GenImageFull22 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
prompt
Prompt
String
secretselect:false
—
—
—
The prompt of the GenImage record
size
Size
String
property
—
—
—
Raw provider size string (1024x1024, 2K, ...), passed through untranslated. Escape hatch for testing — prefer aspectRatio
aspectRatio
Aspect Ratio
String
property
—
—
1:13:44:39:1616:9
Framing of the generated image, translated per provider. An explicit size overrides it
resolution
Resolution
String
property
—
—
1K2K4K
Size tier of the generated image, translated per provider; empty leaves the provider on its default size
n
Count
Int!
property
1
—
—
genImage.n.desc
model
Model
String!
property
—
—
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
Model override, uses the provider default when empty
refImages
Reference Images
[File]reference
property
[]
—
—
Images handed to the provider as visual references, keeping the result consistent with them
derivatives
Derivatives
[String]
property
[]
—
thumbportrait
Extra outputs made from the generated images once they are stored: a crop, or a portrait drawn from them
thumbWindow
Thumbnail Window
[Float]
property
[]
—
—
Horizontal [from, to] fractions of the image the square thumbnail is cut from; the whole width when empty
images
Images
[File]!reference
property
[]
—
—
The images of the GenImage record
thumbs
Thumbs
[File]!reference
property
[]
—
—
The square thumbnail made from the first generated image right after it is stored
errMsg
Error
String
property
—
—
—
The error message of the GenImage record
status
Status
String!
property
pending
—
pendinggeneratingcompletedfailed
The status of the GenImage record
heartbeatAt
Heartbeat At
Date
hidden
—
—
—
When the process holding this generation last reported itself alive; a stale one means nobody is holding it
attempts
Attempts
Int
hidden
0
—
—
How many generation requests this image has cost so far, counting the ones a restart forced to be repeated
derivedAt
Derived At
Date
hidden
—
—
—
When the derivative pass settled - produced, had nothing to produce, or gave up. Empty means the record still owes one
derivativeAttempts
Derivative Attempts
Int
hidden
0
—
—
How many times the derivative pass has been started, counted apart from the image's own attempts
portraitPrompt
Portrait Prompt
String
hidden
—
—
—
The instruction a portrait thumbnail is drawn with, the first generated image as its reference
GenVideogenVideogenai
A video generated from a prompt via a video generation model.
GenVideoFull29 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
prompt
Prompt
String
secretselect:false
—
—
—
The prompt of the GenVideo record
negativePrompt
Negative Prompt
String
secretselect:false
—
—
—
Terms sent in the vendor's own negative field. Empty on a model that has none — there the same list is already inside the prompt.
imageUrl
Image Url
String
property
—
—
—
Source frame url handed to the vendor untranslated. Escape hatch for a frame we never stored — prefer refImages
aspectRatio
Aspect Ratio
String
property
—
—
9:1616:91:14:5
Framing of the generated video, translated per vendor. Vendors that cannot frame it fall back to their own default
resolution
Resolution
String
property
—
—
480p720p1080p
Output resolution tier, translated per vendor and snapped to the nearest tier the model can make. Empty keeps the vendor's default
durationSeconds
Duration (seconds)
Int
property
—
—
—
Requested length of the generated video, snapped to the nearest length the vendor allows
seed
Seed
Int
property
—
—
—
Number the vendor rolls its noise from, so the same request returns the same video. Sent only to a model that has the field; empty means the vendor rolls its own
guidance
Guidance
Float
property
—
—
—
How hard the vendor is held to the prompt (CFG), in that vendor's own scale and clamped to the range its model publishes
audio
Audio
Boolean
property
—
—
—
Whether the vendor was asked to make its own soundtrack. Empty means the vendor's default, which is on.
model
Model
String!
property
—
—
dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-4.0kling-v3kling-v3-omnigemini-omni-1.1-flashveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit
Video generation model to use
refImages
Frames
[File]reference
property
[]
—
—
The opening frame and, second, the closing one — position is the meaning here
assetImages
Asset References
[File]reference
property
[]
—
—
Images the shot is not held to, carrying identity through the clip
personImages
Photoreal References
[File]reference
property
[]
—
—
The frames and asset references that are photoreal. Seedance registers them in its asset library and sends them from there
assetAudios
Voice References
[File]reference
property
[]
—
—
Voice clips whose timbre the characters speak with, sent in this order where the model takes them
sourceVideo
Source Video
Filereference
property
—
—
—
The video this generation edits. Sent by its public url, so a file without one never leaves
keepSourceAudio
Keep Source Audio
Boolean
property
—
—
—
Whether the edit keeps the source's own sound instead of making new sound. Only a model that can choose reads it
video
Video
Filereference
property
—
—
—
The video of the GenVideo record
resultModel
Result Model
String
property
—
—
—
Actual model name returned by the provider
errMsg
Error
String
property
—
—
—
The error message of the GenVideo record
status
Status
String!
property
pending
—
pendinggeneratingcompletedfailed
The status of the GenVideo record
providerTask
Provider Task
Any
hidden
—
—
—
Handle of the job submitted to the provider, the only way a generation interrupted by a restart is picked back up
startedAt
Started At
Date
hidden
—
—
—
When the job was submitted to the provider, the point the waiting budget is counted from
heartbeatAt
Heartbeat At
Date
hidden
—
—
—
When the process holding this generation last reported itself alive; a stale one means nobody is holding it
refAudioCuts
Voice Cuts
[ID]
hidden
[]
—
—
Voice clips cut and stored only so this generation could send them, removed once it completes or fails
vendorAssets
Vendor Assets
[String]
hidden
[]
—
—
Asset-library ids this generation sends instead of picture urls, deleted once it completes or fails unless another running generation still sends them
SessionChatsessionChatgenai
Agent session chat message
SessionChatFull10 fields
FieldTypeKindDefaultConstraintsValuesDescription
id
ID
ID!
property
—
—
—
Unique ID value
createdAt
CreatedAt
Date!
property
—
—
—
Data created time
updatedAt
UpdatedAt
Date!
property
—
—
—
Data updated time
removedAt
RemovedAt
Date
property
—
—
—
Data removed time
agentSession
Session
ID!
property
—
—
—
Owning agent session
role
Role
String!
property
user
—
userassistant
Message author role
content
Content
String
property
—
—
Message text (assistant = markdown)
parts
Parts
[AgentChatPart]!
property
[]
—
—
Ordered timeline of text + tool parts (assistant turns)
files
Files
[File]!reference
property
[]
—
—
Images the user handed the conversation on this message
seq
Seq
Int!
property
0
—
—
Per-session ordering key

Scalar Models

BoardPinFaceboardPinFacesceny
Name and thumbnail read from the asset a pin points at.
FieldTypeKindDefaultConstraintsValuesDescription
name
Name
String
property
—
—
—
Name of the asset the pin points at
img
Image
String
property
—
—
—
Thumbnail shown on the canvas card
media
Media
String!
property
photo
—
photovideoaudio
How the canvas should draw the asset
pending
Pending
Boolean!
property
false
—
—
Whether the image is still being drawn
failed
Failed
Boolean
property
—
—
—
Whether drawing the image failed and there is no picture to show
drawn
Drawn
Boolean
property
—
—
—
Whether the asset is a sheet drawn by AI rather than a picture of its own
fileId
File ID
String
property
—
—
—
ID of the file the canvas card shows, when it shows a picture
detail
Detail
String
property
—
—
—
What a board asset is in words: its description with its gender or product type
model
Model
String
property
—
—
—
The image model that drew the picture, empty for an uploaded one
CutFramecutFramesceny
One beat of the plan: what happens in it, how it is shot, and its share of the video's length.
FieldTypeKindDefaultConstraintsValuesDescription
body
Body
String
property
—
—
What happens in this beat. Write an asset as @slot and bind that slot to a sheet to carry its look.
framing
Framing
String
property
—
—
widefullmediumcloseUpextremeCloseUpinsert
How much of the subject the frame holds
angle
Angle
String
property
—
—
eyeLevellowhightopDowndutchpov
Where the camera looks from
lens
Lens
String
property
—
—
wideAnglestandardtelephotomacroanamorphicshallowDepthdeepFocus
Lens character - only meaningful for live action and 3D
camera
Camera Move
String
property
—
—
staticpantiltpushInpullOuttrackcraneorbithandheldzoom
How the camera moves in this beat
light
Light
String
property
—
—
naturalsofthardbacklitlowKeyhighKeyflatpracticalgoldenHourneon
How the shot is lit
color
Color
String
property
—
—
naturalwarmcoolpastelvividmonochromehighContrast
Colour treatment of this beat
speed
Speed
String
property
—
—
realtimeslowMotiontimeLapserampUprampDownhold
How time runs in this beat
sound
Sound
String
property
—
—
What is heard in this beat, in words - a fridge door opening, a distant siren
seconds
Seconds
Int
property
—
—
—
This beat's share of the length in whole seconds; set it on every beat or on none.
CutSlotcutSlotsceny
A name the cut bodies write in braces, and the asset sheet it stands for.
FieldTypeKindDefaultConstraintsValuesDescription
name
Slot
String!
property
—
—
—
The name written as @name in a cut body. The bodies own it - renaming it here does nothing.
parentType
Asset Type
String
property
—
—
videoCharactervideoScenevideoObj
Which kind of sheet this slot is bound to
parent
Asset
ID
property
—
—
—
The sheet this slot stands for. Empty until somebody binds it.
GenPromptPartgenPromptPartsceny
One labeled piece of a generation prompt.
FieldTypeKindDefaultConstraintsValuesDescription
source
Source
String!
property
rule
—
settingprojectflowcutshotassetrulerefined
Where this piece came from.
settingPath
Setting Path
String
property
—
—
The setting field that owns this piece, when one does.
label
Label
String
property
—
—
Human-readable name of the piece.
text
Text
String
property
—
—
The text merged into the prompt.
GenPromptPreviewgenPromptPreviewsceny
An assembled generation prompt, broken into the pieces it was built from.
FieldTypeKindDefaultConstraintsValuesDescription
kind
Kind
String!
property
image
—
imagevideo
Image or video.
prompt
Prompt
String
property
—
—
What actually goes to the provider.
parts
Parts
[GenPromptPart]!
property
[]
—
—
The pieces the prompt was built from.
model
Model
String
property
—
—
The generation model this prompt would run on.
refImages
Reference Images
[File]!reference
property
[]
—
—
Images attached alongside the prompt.
warnings
Warnings
[String]!
property
[]
—
—
What would have blocked a real generation.
MediaStylemediaStylesceny
MediaStyle description
FieldTypeKindDefaultConstraintsValuesDescription
medium
Medium
String
property
liveAction
—
liveActionanimationillustrationthreeDmixed
Medium description
moods
Moods
[String]!
property
[]
—
friendlyenergeticplayfultrustworthysophisticatedemotionalintense
No longer used; leave it empty
colorTone
Color Tone
String
property
—
—
naturalwarmcoolpastelvividmonochromehighContrast
No longer used; leave it out
keywords
Keywords
[String]!
property
[]
—
—
Keywords description
PlanRoleplanRolesceny
One asset the plan needs: the @slot the beats write, what kind of asset plays it and how it is made.
FieldTypeKindDefaultConstraintsValuesDescription
name
Slot
String
property
—
—
The @slot name the beat bodies write, spelled exactly the same. The bodies own it.
type
Asset Type
String!
property
videoCharacter
—
videoCharactervideoScenevideoObj
A person or a part of one is a character, a place is a scene, a product or prop is an object
description
Description
String
property
—
—
What the asset looks like: its sheet is drawn from this
gender
Gender
String
property
—
—
malefemaleother
Characters only
productType
Product Type
String
property
—
—
—
Objects only — what kind of product it is, e.g. lip balm
needsPhoto
Real Product
Boolean!
property
false
—
—
The video must show this object exactly as it is, so a photo of it should be uploaded
photo
Photo
Filereference
property
—
—
—
The uploaded photo. An object with a photo becomes that photo and is not drawn
RefAssetrefAssetsceny
One asset on a board: the copy it plays and the @slot it plays it in.
FieldTypeKindDefaultConstraintsValuesDescription
type
Type
String
property
—
—
videoCharactervideoScenevideoObjcreative
Which kind of asset the copy is. Empty means a file uploaded straight onto the board.
relation
Relation
String
property
—
—
—
The @slot name in the plan this asset plays, such as Person1. Empty rides as a reference picture only.
asset
Asset Copy
ID
property
—
—
—
The copy made when the asset was assigned to this board
file
File
LightFilereference
property
—
—
—
A file uploaded straight onto the board
TakeCasttakeCastsceny
One board asset as it rode a render: its name, look and picture at that moment
FieldTypeKindDefaultConstraintsValuesDescription
type
Type
String
property
—
—
videoCharactervideoScenevideoObjcreative
Which kind of asset it was. Empty means a file put straight onto the board
relation
Relation
String
property
—
—
—
The @slot it played. Empty rode as a reference picture only
name
Name
String
property
—
—
The asset's name
description
Description
String
property
—
—
What the asset looked like
gender
Gender
String
property
—
—
malefemaleother
Characters only
productType
Product Type
String
property
—
—
—
Objects only
profile
Profile
String
property
—
—
—
Characters only: age, height, build, hair, outfit and intro as one prompt line
picture
Picture
Filereference
property
—
—
—
The picture that rode the render. Empty when the asset had none yet
voice
Voice
Filereference
property
—
—
—
A character's reference voice as it stood at the press. The render sends it only with sound on
genImage
Generation
GenImagereference
property
—
—
—
The generation that drew the picture; its thumbnail is the face a card shows. Empty for an uploaded picture
TakePlantakePlansceny
The plan a video was rendered from, as it stood at that moment
FieldTypeKindDefaultConstraintsValuesDescription
phrase
Catchphrase
String
property
—
—
The plan's catchphrase
summary
Story
String
property
—
—
The plan's story
cutFrames
Cuts
[CutFrame]!
property
[]
—
—
The beats, in order
roles
Assets
[PlanRole]!
property
[]
—
—
The assets the plan names
projectBrief
Project Brief
String
property
—
—
—
The project's title and description at that moment
inspiration
Reference Ad
ID
property
—
—
—
The catalog ad the plan followed when the video was made
inspirationReason
Why This Ad
String
property
—
—
Why the matcher picked the reference ad, in one sentence; empty when the ad was pinned
TakeSpectakeSpecsceny
The board's spec and look as a video was rendered from it
FieldTypeKindDefaultConstraintsValuesDescription
aspectRatio
Aspect Ratio
String!
property
9:16
—
9:1616:91:14:5
The video's aspect ratio
durationSeconds
Length
Int!
property
15
—
—
The video's length in seconds
audio
Audio
Boolean!
property
false
—
—
Whether sound was made with the video
bgm
BGM
Boolean!
property
false
—
—
Whether the sound carried background music
narration
Narration
Boolean!
property
false
—
—
Whether the sound carried a narrator's voice-over
soundEffect
Sound Effects
Boolean!
property
false
—
—
Whether the sound carried sound effects
mediaStyle
Look
MediaStyle
property
—
—
—
Medium and keywords
videoStyle
Video Style
VideoStyle
property
—
—
—
Pace and reference prompt
refImages
References
[File]!reference
property
[]
—
—
The board's reference pictures that rode the render
startFrame
Start Frame
Filereference
property
—
—
—
The pinned opening frame
endFrame
End Frame
Filereference
property
—
—
—
The pinned closing frame
videoGenModel
Pinned Model
String
property
—
—
dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-4.0kling-v3kling-v3-omnigemini-omni-1.1-flashveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit
The video model the board pinned. Empty lets the spec choose
resolution
Resolution
String
property
—
—
480p720p1080p
The tier asked for. Empty rode at the model's usual tier and was priced as 720p
model
Model
String
property
—
—
dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-4.0kling-v3kling-v3-omnigemini-omni-1.1-flashveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit
The video model this take went out on
VideoStylevideoStylesceny
Shared concept and tone vocabulary for stories, assets and projects.
FieldTypeKindDefaultConstraintsValuesDescription
pace
Pace
String
property
—
—
slownormalfast
videoStyle.pace.desc
referencePrompt
Reference Prompt
String
property
—
—
English style prompt injected into generation
MemoStylememoStylesceny
How a text block on the canvas is drawn: its size, color, weight and slant.
FieldTypeKindDefaultConstraintsValuesDescription
size
Text Size
String!
property
small
—
smallmediumlarge
Size of the text: small 16px, medium 24px, large 40px
color
Text Color
String!
property
label
—
labelredorangeyellowgreenbluevioletpink
Color of the text; label is the theme's own text color
bold
Bold
Boolean!
property
false
—
—
Whether the text is bold
italic
Italic
Boolean!
property
false
—
—
Whether the text is italic
NotiInfonotiInfoshared
Noti Info
FieldTypeKindDefaultConstraintsValuesDescription
setting
Setting
String!
property
normal
—
disagreefewernormalblock
Setting
pauseUntil
Pause Until
Date!
property
[function]
—
—
Pause Until
deviceTokens
Device Tokens
[DeviceToken]!
property
[]
—
—
Device Tokens
EncourageInfoencourageInfoshared
Encourage Info
FieldTypeKindDefaultConstraintsValuesDescription
journey
Journey
String!
property
welcome
—
welcomewaitingfirstJoinjoinedleavingleavedreturningreturned
Journey
journeyAt
Journey At
Date!
property
[function]
—
—
Journey At
inquiry
Inquiry
String!
property
welcome
—
welcomepayablewaitPaypaidmorePayablewaitMorePayinquiredconcernedconcernedPayableconcernedWaitPayashedvipkicked
Inquiry
inquiryAt
Inquiry At
Date!
property
[function]
—
—
Inquiry At
RestrictInforestrictInfoshared
Restrict Info
FieldTypeKindDefaultConstraintsValuesDescription
until
Until
Date!
property
—
—
—
Until
reason
Reason
String!
property
—
—
—
Reason
LeaveInfoleaveInfoshared
Leave Info
FieldTypeKindDefaultConstraintsValuesDescription
type
Type
String!
property
noReply
—
noReplycomebackunsatisfiedother
Type
reason
Reason
String
property
—
—
—
Reason
satisfaction
Satisfaction
Int
property
—
min 1max 5
—
Satisfaction
voc
VOC
String
property
—
—
—
VOC
at
At
Date!
property
[function]
—
—
At
AgentPlanStepagentPlanStepgenai
One step of the work a turn plans to do
FieldTypeKindDefaultConstraintsValuesDescription
stepId
Step ID
String!
property
—
—
—
Upsert key for stream frames of this step
order
Order
Int!
property
0
—
—
Execution order within the plan
kind
Kind
String!
property
—
—
—
Host-defined step type
title
Title
String
property
—
—
Human wording shown on the timeline
input
Input
Any
property
—
—
—
Host payload for this step
status
Status
String!
property
pending
—
pendingrunningdonefailedskipped
Step progress
summary
Summary
String
property
—
—
—
One-line result of the step
errMsg
Error
String
property
—
—
—
Why the step failed
AgentQuestionagentQuestiongenai
A question the agent paused a turn to ask, and the answer it received
FieldTypeKindDefaultConstraintsValuesDescription
questionId
Question ID
String!
property
—
—
—
Identifies this question so a stale or duplicate answer can be rejected
header
Header
String
property
—
—
Short chip label
question
Question
String
property
—
—
The question shown to the user
options
Options
[AgentQuestionOption]!
property
[]
—
—
Selectable answers
multiSelect
Multi Select
Boolean!
property
false
—
—
More than one option may be chosen
freeText
Free Text
Boolean!
property
true
—
—
A typed answer is accepted
answerKeys
Answer Keys
[String]!
property
[]
—
—
Keys of the chosen options
answerText
Answer Text
String
property
—
—
—
The typed answer, when there was one
AgentChatPartagentChatPartgenai
One ordered part of an assistant turn
FieldTypeKindDefaultConstraintsValuesDescription
type
Type
String!
property
text
—
texttoolquestionstep
Which payload this part carries
text
Text
String
property
—
—
—
Markdown text slice
tool
Tool
AgentToolEvent
property
—
—
—
Tool call at this point in the turn
question
Question
AgentQuestion
property
—
—
—
Question asked at this point, with its answer
step
Step
AgentPlanStep
property
—
—
—
Plan step finished at this point
DeviceTokendeviceTokenshared
A device's push address
FieldTypeKindDefaultConstraintsValuesDescription
token
Token
String!
property
—
—
—
The APNs device token or FCM registration token
provider
Provider
String!
property
fcm
—
apnsfcm
The service the push goes through
platform
Platform
String!
property
web
—
iosandroidweb
The platform of the device
deviceId
Device ID
String
property
—
—
—
The installation the token belongs to
updatedAt
UpdatedAt
Date!
property
[function]
—
—
Data updated time
AgentQuestionOptionagentQuestionOptiongenai
One selectable answer to an agent's question
FieldTypeKindDefaultConstraintsValuesDescription
key
Key
String!
property
—
—
—
Stable id the client sends back
label
Label
String
property
—
—
Text shown on the option
detail
Detail
String
property
—
—
—
Optional one-line elaboration
recommended
Recommended
Boolean!
property
false
—
—
The option a user can take without deliberating
AgentToolEventagentToolEventgenai
Coding-agent tool event
FieldTypeKindDefaultConstraintsValuesDescription
op
Operation
String!
property
unknown
—
—
File operation
phase
Phase
String!
property
start
—
startresult
Tool lifecycle phase
toolName
Tool Name
String!
property
—
—
—
Tool name
toolCallId
Tool Call ID
String!
property
—
—
—
Tool call ID
path
Path
String
property
—
—
—
Affected file path
isError
Is Error
Boolean
property
—
—
—
Whether the tool call failed
summary
Summary
String
property
—
—
—
Result summary

Enums

EnumTypeValuesUsed By
adminRole
adminRole
String
viewermanageradminsuperAdmin
admin.rolesadmin.rolesadmin.roles
agentChatPartType
agentChatPartType
String
texttoolquestionstep
agentChatPart.type
agentPlanStepStatus
agentPlanStepStatus
String
pendingrunningdonefailedskipped
agentPlanStep.status
agentSessionStatus
agentSessionStatus
String
idlethinkingawaitingeditingfailed
agentSession.statusagentSession.statusagentSession.status
agentToolPhase
agentToolPhase
String
startresult
agentToolEvent.phase
assetKind
assetKind
String
originalclone
creative.assetKindcreative.assetKindvideoCharacter.assetKindvideoCharacter.assetKindvideoObj.assetKindvideoObj.assetKindvideoPlan.assetKindvideoPlan.assetKindvideoScene.assetKindvideoScene.assetKind
assetOrigin
assetOrigin
String
userplansceny
videoCharacter.originvideoCharacter.originvideoCharacter.originvideoCharacter.origin
boardPinMedia
boardPinMedia
String
photovideoaudio
boardPinFace.media
boardPinType
boardPinType
String
videoCharactervideoScenevideoObjcreativefilevideoBoardgenImagevideoPlanvideoTake
boardPin.targetTypeboardPin.targetTypeboardPin.targetTypeboardPin.targetType
characterGender
characterGender
String
malefemaleother
videoCharacter.gendervideoCharacter.gendervideoCharacter.gendervideoCharacter.genderplanRole.gendertakeCast.gender
colorTone
colorTone
String
naturalwarmcoolpastelvividmonochromehighContrast
cutFrame.colormediaStyle.colorTone
creativeType
creativeType
String
photovideoaudio
creative.typecreative.typecreative.type
creditJob
creditJob
String
videoimageregeneratecharactersceneobjinspect
creditLog.jobcreditLog.jobcreditLog.job
creditLogStatus
creditLogStatus
String
pendingsettledrefunded
creditLog.statuscreditLog.statuscreditLog.status
creditLogType
creditLogType
String
grantdeductuserefund
creditLog.typecreditLog.typecreditLog.typecreditLog.type
cutAngle
cutAngle
String
eyeLevellowhightopDowndutchpov
cutFrame.angle
cutAssetType
cutAssetType
String
videoCharactervideoScenevideoObj
cutSlot.parentTypeplanRole.type
cutCameraMove
cutCameraMove
String
staticpantiltpushInpullOuttrackcraneorbithandheldzoom
cutFrame.camera
cutFraming
cutFraming
String
widefullmediumcloseUpextremeCloseUpinsert
cutFrame.framing
cutLens
cutLens
String
wideAnglestandardtelephotomacroanamorphicshallowDepthdeepFocus
cutFrame.lens
cutLight
cutLight
String
naturalsofthardbacklitlowKeyhighKeyflatpracticalgoldenHourneon
cutFrame.light
cutSpeed
cutSpeed
String
realtimeslowMotiontimeLapserampUprampDownhold
cutFrame.speed
devicePlatform
devicePlatform
String
iosandroidweb
deviceToken.platform
fileStatus
fileStatus
String
activeuploadingfailed
file.statusfile.statusfile.status
genImageDerivative
genImageDerivative
String
thumbportrait
genImage.derivativesgenImage.derivativesgenImage.derivatives
genImageStatus
genImageStatus
String
pendinggeneratingcompletedfailed
genImage.statusgenImage.statusgenImage.status
genPromptKind
genPromptKind
String
imagevideo
genPromptPreview.kind
genPromptSource
genPromptSource
String
settingprojectflowcutshotassetrulerefined
genPromptPart.source
genVideoStatus
genVideoStatus
String
pendinggeneratingcompletedfailed
genVideo.statusgenVideo.statusgenVideo.status
imageAspectRatio
imageAspectRatio
String
1:13:44:39:1616:9
genImage.aspectRatiogenImage.aspectRatiogenImage.aspectRatio
imageGenModel
imageGenModel
String
gemini-3.1-flash-lite-imagegemini-nano-banana-2.1gemini-3.1-flash-imagegpt-image-2.5-sunburstgpt-image-2dola-seedream-5-0-pro-260628dola-seedream-5-0-flash-260915seedream-5-0-260128seedream-5-0-lite-260128
videoBoard.refGenModelvideoBoard.refGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelgenImage.modelgenImage.modelgenImage.modelgenImage.model
imageResolution
imageResolution
String
1K2K4K
videoCharacter.lastGenResolutionvideoCharacter.lastGenResolutionvideoCharacter.lastGenResolutionvideoCharacter.lastGenResolutionvideoObj.lastGenResolutionvideoObj.lastGenResolutionvideoObj.lastGenResolutionvideoObj.lastGenResolutionvideoScene.lastGenResolutionvideoScene.lastGenResolutionvideoScene.lastGenResolutionvideoScene.lastGenResolutiongenImage.resolutiongenImage.resolutiongenImage.resolution
inquiry
inquiry
String
welcomepayablewaitPaypaidmorePayablewaitMorePayinquiredconcernedconcernedPayableconcernedWaitPayashedvipkicked
encourageInfo.inquiry
journey
journey
String
welcomewaitingfirstJoinjoinedleavingleavedreturningreturned
encourageInfo.journey
leaveType
leaveType
String
noReplycomebackunsatisfiedother
leaveInfo.type
medium
medium
String
liveActionanimationillustrationthreeDmixed
videoCharacter.mediumvideoCharacter.mediumvideoCharacter.mediumvideoObj.mediumvideoObj.mediumvideoObj.mediumvideoScene.mediumvideoScene.mediumvideoScene.mediummediaStyle.medium
memoColor
memoColor
String
labelredorangeyellowgreenbluevioletpink
memoStyle.color
memoSize
memoSize
String
smallmediumlarge
memoStyle.size
mood
mood
String
friendlyenergeticplayfultrustworthysophisticatedemotionalintense
mediaStyle.moods
notiSetting
notiSetting
String
disagreefewernormalblock
notiInfo.setting
periodType
periodType
String
non-periodicactivehourlydailyweeklymonthly
summary.typesummary.typesummary.type
profileStatus
profileStatus
String
activeprepareappliedapprovedreappliedfeaturedreservedrejected
user.profileStatususer.profileStatususer.profileStatus
pushProvider
pushProvider
String
apnsfcm
deviceToken.provider
refAssetType
refAssetType
String
videoCharactervideoScenevideoObjcreative
refAsset.typetakeCast.type
sessionChatRole
sessionChatRole
String
userassistant
sessionChat.rolesessionChat.rolesessionChat.rolesessionChat.role
summaryStatus
summaryStatus
String
activearchived
summary.statussummary.status
userLanguage
userLanguage
String
enko
user.languageuser.language
userRole
userRole
String
rootadminuserbusinessguest
user.rolesuser.rolesuser.roles
userStatus
userStatus
String
prepareactivedormantrestricted
user.statususer.statususer.status
userTheme
userTheme
String
systemlightdark
user.themeuser.theme
verify
verify
String
naverkakaogithubgoogleapplefacebookwalletpasswordphoneemail
user.verifiesuser.verifies
videoAspectRatio
videoAspectRatio
String
9:1616:91:14:5
creditLog.aspectRatiocreditLog.aspectRatiocreditLog.aspectRatiovideoBoard.aspectRatiovideoBoard.aspectRatiovideoBoard.aspectRatiovideoBoard.aspectRatiogenVideo.aspectRatiogenVideo.aspectRatiogenVideo.aspectRatiotakeSpec.aspectRatio
videoGenModel
videoGenModel
String
dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-4.0kling-v3kling-v3-omnigemini-omni-1.1-flashveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit
videoBoard.videoGenModelvideoBoard.videoGenModelvideoBoard.videoGenModelvideoBoard.videoGenModelgenVideo.modelgenVideo.modelgenVideo.modelgenVideo.modeltakeSpec.videoGenModeltakeSpec.model
videoPace
videoPace
String
slownormalfast
videoStyle.pace
videoResolution
videoResolution
String
480p720p1080p
videoBoard.resolutionvideoBoard.resolutionvideoBoard.resolutionvideoBoard.resolutiongenVideo.resolutiongenVideo.resolutiongenVideo.resolutiontakeSpec.resolution