Raw schema
{
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "The order id, or the customer-facing order reference shown on the website (for example A140A800)."
},
"intake": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"title",
"briefText",
"beats",
"safetyAcknowledged"
],
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 120
},
"briefText": {
"type": "string",
"minLength": 20,
"maxLength": 20000
},
"beats": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 3,
"maxLength": 240
}
},
"beatLocations": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 2,
"maxLength": 120
}
},
"constraints": {
"type": "object",
"additionalProperties": false,
"properties": {
"locationNotes": {
"type": "string",
"maxLength": 1000
},
"accessNotes": {
"type": "string",
"maxLength": 1000
},
"soundNotes": {
"type": "string",
"maxLength": 1000
},
"lightNotes": {
"type": "string",
"maxLength": 1000
},
"mobilityNotes": {
"type": "string",
"maxLength": 1000
},
"safetyNotes": {
"type": "string",
"maxLength": 1000
},
"availableMinutes": {
"type": "integer",
"minimum": 15,
"maximum": 1440
},
"locationTransferMinutes": {
"type": "integer",
"minimum": 0,
"maximum": 720
}
}
},
"safetyAcknowledged": {
"const": true
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"intakeVersion",
"title",
"requirements",
"locations",
"beats",
"safetyAcknowledged"
],
"properties": {
"intakeVersion": {
"const": 2
},
"title": {
"type": "string",
"minLength": 3,
"maxLength": 120
},
"context": {
"type": "string",
"maxLength": 20000,
"description": "Optional private context. Never interpreted or used to change the plan."
},
"requirements": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"requirementId",
"text",
"importance"
],
"properties": {
"requirementId": {
"type": "string",
"pattern": "^RQ-[0-9]{2}$"
},
"text": {
"type": "string",
"minLength": 3,
"maxLength": 240
},
"importance": {
"enum": [
"essential",
"useful",
"optional"
]
}
}
}
},
"locations": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"locationId",
"name"
],
"properties": {
"locationId": {
"type": "string",
"pattern": "^L-[0-9]{2}$"
},
"name": {
"type": "string",
"minLength": 2,
"maxLength": 120
},
"accessWindow": {
"type": "object",
"additionalProperties": false,
"required": [
"startMinute",
"endMinute"
],
"properties": {
"startMinute": {
"type": "integer",
"minimum": 0,
"maximum": 1440
},
"endMinute": {
"type": "integer",
"minimum": 1,
"maximum": 1440
}
}
},
"acoustics": {
"enum": [
"quiet",
"noise_controllable",
"noise_fixed",
"unknown"
]
},
"quieterPosition": {
"enum": [
"permitted",
"not_permitted",
"unknown"
]
}
}
}
},
"participants": {
"type": "array",
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"participantId",
"label"
],
"properties": {
"participantId": {
"type": "string",
"pattern": "^P-[0-9]{2}$"
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"window": {
"type": "object",
"additionalProperties": false,
"required": [
"startMinute",
"endMinute"
],
"properties": {
"startMinute": {
"type": "integer",
"minimum": 0,
"maximum": 1440
},
"endMinute": {
"type": "integer",
"minimum": 1,
"maximum": 1440
}
}
}
}
}
},
"beats": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"beatId",
"label",
"purpose",
"requirementIds",
"locationId"
],
"properties": {
"beatId": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
},
"label": {
"type": "string",
"minLength": 3,
"maxLength": 120
},
"purpose": {
"enum": [
"interview_answer",
"voiceover_line",
"process_step",
"result_reveal",
"place_context",
"closing_action",
"live_moment",
"dialogue_exchange"
]
},
"requirementIds": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^RQ-[0-9]{2}$"
}
},
"locationId": {
"type": "string",
"pattern": "^L-[0-9]{2}$"
},
"repeatable": {
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether this key moment can be filmed again. When omitted, it is treated as not confirmed repeatable, so it is planned as one take."
},
"speech": {
"enum": [
"none",
"on_camera",
"voiceover"
]
},
"participantIds": {
"type": "array",
"maxItems": 12,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^P-[0-9]{2}$"
}
},
"keyDetail": {
"type": "string",
"minLength": 3,
"maxLength": 160
},
"actionSeconds": {
"type": "integer",
"minimum": 5,
"maximum": 3600
},
"continuousMinutes": {
"type": "integer",
"minimum": 1,
"maximum": 480
},
"eventStartMinute": {
"type": "integer",
"minimum": 0,
"maximum": 1440
},
"eventStartFlexible": {
"const": true
},
"dependsOn": {
"description": "Earlier stages that must finish first. Omit to follow the preceding process/result stage in input order. Use [] only for a genuinely independent or already prepared result.",
"type": "array",
"maxItems": 19,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
}
}
}
}
},
"resources": {
"type": "object",
"additionalProperties": false,
"properties": {
"operators": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"captureDevices": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"equipment": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"enum": [
"phone",
"camera",
"tripod",
"gimbal",
"external_microphone",
"lights",
"drone"
]
}
}
}
},
"planningConstraints": {
"type": "object",
"additionalProperties": false,
"properties": {
"availableMinutes": {
"type": "integer",
"minimum": 15,
"maximum": 1440
},
"cameraMovement": {
"enum": [
"free",
"locked_position"
]
},
"framingLimit": {
"enum": [
"any",
"wide_only"
]
},
"transferMinutes": {
"type": "integer",
"minimum": 0,
"maximum": 720
},
"transfers": {
"type": "array",
"minItems": 1,
"maxItems": 6,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"fromLocationId",
"toLocationId",
"minutes"
],
"properties": {
"fromLocationId": {
"type": "string"
},
"toLocationId": {
"type": "string"
},
"minutes": {
"type": "integer",
"minimum": 0,
"maximum": 720
}
}
}
},
"orientations": {
"type": "array",
"minItems": 1,
"maxItems": 2,
"uniqueItems": true,
"items": {
"enum": [
"landscape",
"portrait",
"square"
]
}
},
"multiOrientationMethod": {
"enum": [
"separate_takes",
"crop_from_one",
"unknown"
]
}
}
},
"ownFootageOnly": {
"const": true,
"description": "Customer films their own material. Same meaning as noAiImagery; omit or send true."
},
"noAiImagery": {
"const": true,
"description": "Legacy compatibility field; omit or send true. The customer films their own material."
},
"safetyAcknowledged": {
"const": true
}
}
}
]
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"orderId",
"intake",
"idempotencyKey"
],
"additionalProperties": false
}