Ruwana Developer Documentation
Archive successful media within the fixed 7-day delivery window.
Platform media URLs are temporary delivery, not permanent asset storage. Successful API responses include explicit retention metadata so an integration can archive the result to its own long-term storage.
Successful response metadata
{
"media": {
"retentionDays": 7,
"expiresAt": "2026-09-10T12:00:00.000Z",
"state": "available",
"clientStorageRequired": true
}
}Fixed from completion
The expiry is calculated from the original successful completion time.
Replay never extends it
Idempotent replay returns the same logical request and preserves the original expiry.
History outlives media
Request, usage and billing records remain after the delivery objects expire.
After expiry
Platform marks media state as expired and removes dead result/download URLs from the stored response. For multi-format Image results, the delivery entries remain descriptive but expired file URLs become unavailable.
Integration rule: copy every asset you need to keep before
expiresAt. Do not use repeated status/idempotency calls as a storage extension mechanism.