1
Submit the URL
202 Accepted with the ingestion projection and a Location header. Replaying the same idempotency key and body returns the original ingestion with X-Idempotent-Replay: true.2
Wait for the reference
Poll the ingestion until
referenceId is set: that happens within seconds, once metadata, provenance, and the transcript are durable. Media bytes keep transferring in the background (state stays running until they are verified); wait for succeeded only if you need the bytes right away.3
Read the reference
A succeeded ingestion carries
referenceId.Choosing a media profile
The profile is part of the idempotency hash: the same URL with a different profile is a different ingestion.