Command · Knowledge & Docs
Video Intake
Configure a video intake endpoint — a URL that receives files from an approved app or integration — so submitted video is analyzed and results are delivered to an agent or a folder.
How it works
Video Intake configures an API endpoint — a URL that receives files from another app — so an approved sender integration can submit video for analysis, with results delivered to an agent or a folder. The Command form configures the endpoint; creating an intake is local setup, and no endpoint or results exist until you create it.
Before you start
- A raia Command project
- An approved sender integration or app that will submit video
What you need to make the connection
| Field | Where to get it |
|---|---|
| None for configuration | The form asks for configuration, not external provider credentials. |
| Endpoint key (after Create) | Shown in the creation response and sent as the X-Raia-Intake-Key header. API uploads require this generated intake key — keep it private. |
| Results signing secret (after Create) | Shown in the creation response; it verifies the X-Raia-Signature header on results delivered to your Results URL. |
Recommended practice: keep credentials private. If one is exposed, revoke or rotate it with the provider before reconnecting.
Setup steps
- 01
In raia Command, click Connectors, open Video Intake, then click New video intake. The form opens locally; nothing exists until you create it.
- 02
Enter a Name and optionally a Results URL.
Name the video intake and optionally set a Results URL. - Highlight 1: Name
- Highlight 2: Results URL (optional)
- 03
Choose the analysis Preset, Segments, and Media resolution.
Choose the analysis Preset, Segments, and Media resolution. - Highlight 1: Preset
- Highlight 2: Segments
- Highlight 3: Media resolution
- 04
Write Video instructions, pick the Output choices (Summary, Timed description, Transcript, On-screen text), and decide whether senders can add their own video instructions.
Write Video instructions, pick the Output choices, and decide whether senders can add their own video instructions. - Highlight 1: Video instructions (optional)
- Highlight 2: Output: Summary, Timed description, Transcript, On-screen text
- Highlight 3: Let senders add video instructions (off by default)
- 05
Choose Delivery: Send to the agent delivers results to an agent (pick the Agent and optional instructions for it); Return values only does not.
Choose Delivery: Send to the agent delivers results to an agent; Return values only does not. Agent and its instructions apply only to agent delivery. - Highlight 1: Delivery
- Highlight 2: Agent (agent delivery only)
- Highlight 3: Instructions for the agent (optional)
- 06
Optionally turn on Save results to a folder: choose your knowledge project in Select knowledge, then choose a destination in Select folder — it stays disabled until knowledge is selected. Leave the switch off if you don't want results saved as a document.
With Save results to a folder on, choose Select knowledge first; Select folder becomes available once you choose a Knowledge project. - Highlight 1: Save results to a folder
- Highlight 2: Select knowledge — choose your knowledge project first
- Highlight 3: Select folder — enabled by specifying knowledge first
- 07
Click Create video intake. After Create, the UI shows the endpoint URL and credentials for your approved sender integration — keep them private. The product instructions show the sender sequence: POST to the endpoint's /uploads path with the intake key, PUT the file to the returned upload URL, POST to /jobs/<job_id>/start with the key, then poll GET /jobs/<job_id> until the result is ready.
Optionally save results to a folder, then click Create video intake. Review the delivery and storage choices before creating the intake. - Highlight 1: Save results to a folder
- Highlight 2: Create video intake
Good to know
- After Create video intake, check the creation response for your endpoint and credentials. Keep them private, and check an approved submission’s job status and delivered result before relying on the intake.
- The form's copy does not establish deletion or retention guarantees for collected video; confirm those with your administrator before collecting real footage.
- For your approved sender integration, follow the upload, start and poll sequence and validate result signatures. Configuration alone does not mean a video has been submitted or analyzed.