The “doc” is in the API error message returned after you read the previous version of API documentation and assumed the previous promise of 24 hours, and then attempted retrieval after 60+ minutes elapsed.
"message": "The video is no longer available. Downloads expire after 24 hours.",
There is no “updated” date and no version history to see when the API shape or promised services have been altered in https://platform.openai.com/docs/ , for example, to see the PR that changed documentation from vector stores having been using text-embeddings-3-large to now the 3-small version at the same service pricing. It currently says 1 hour.
One would have to retrieve/download their Sora 2 API video after 60 minutes have elapsed and see if the error message remains incorrect. Someone at OpenAI could just search the API endpoint code base for “video is no longer available” along with “24 hours” and answer this themselves if a change was pushed. Or just make a video and wait.
I kicked off a sora-2 video. We’ll see what the error message looks like after it continues to poll and download for over an hour.
Update: the API error text is fixed, with only a pluralization issue:
2025-10-28 18:43:16,461 ERROR [attempt 6] Final error received during re-download (HTTP 404). Full JSON body follows:
{
"error": {
"message": "The video is no longer available. Downloads expire after 1 hours.",
"type": "invalid_request_error",
"param": null,
"code": null
}
}