Complete robot media (beta)
const url = 'https://api.example.yas/v1/robots/raw/media/62bc5e66-8e11-4940-a70d-22efc1979674/complete';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"partnerId":"partner","schemaVersion":"2026-11","sourceSystem":"partner-export"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.example.yas/v1/robots/raw/media/62bc5e66-8e11-4940-a70d-22efc1979674/complete \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export" }'Beta. Complete makes the file live. Send partnerId, schemaVersion, and sourceSystem. mediaId is the id from mint. PUT the bytes to the minted URL first. An unknown mediaId for this partner is 404. The first complete returns status ready. A repeat on a ready file is 200 with status ready. Complete within 24 hours of minting. A missing upload is 409 upload_incomplete; a size or type mismatch is 422 invalid_media. A credential may expire before the completion deadline: an already uploaded valid object can still complete. Mint again for invalid content because objects cannot be overwritten.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Id returned by mint.
Example
62bc5e66-8e11-4940-a70d-22efc1979674Request Bodyrequired
Section titled “Request Bodyrequired”object
Partner id. It must match the server key.
Schema version of this body. Example: 2026-11.
Name of the system that sent this body. Example: partner-export.
Example
{ "partnerId": "partner", "schemaVersion": "2026-11", "sourceSystem": "partner-export"}Responses
Section titled “Responses”File is live. status is ready. A repeat on a ready file is 200 with status ready.
object
ready means the file is live.
Example
{ "mediaId": "62bc5e66-8e11-4940-a70d-22efc1979674", "status": "ready"}400A required field is missing.
object
Stable error code. No stack trace.
Example
{ "error": "invalid_body"}401The server key is missing or wrong.
object
Stable error code. No stack trace.
Example
{ "error": "invalid_credentials"}403A server key may be limited to vehicles, robots, or both. A call outside that limit is 403 `forbidden` and stores nothing. `identity_mismatch` means `partnerId` does not match the server key.
object
Stable error code. No stack trace.
Example
{ "error": "forbidden"}404Unknown `mediaId`. Nothing is stored.
object
Stable error code. No stack trace.
Example
{ "error": "not_found"}409No completed object is available yet. Upload before the credential expires and retry complete.
object
Stable error code. No stack trace.
Example
{ "error": "upload_incomplete"}410The 24-hour completion deadline has expired. Mint again; a previous ready map is unchanged.
object
Stable error code. No stack trace.
Example
{ "error": "upload_expired"}422The uploaded object does not match its declared size or type. Mint again and upload valid bytes; the object cannot be overwritten.
object
Stable error code. No stack trace.
Example
{ "error": "invalid_media"}503Storage or its required configuration is unavailable. Retry after the Retry-After interval.
object
Stable error code. No stack trace.
Example
{ "error": "unavailable"}