Skip to content

Complete robot media (beta)

Beta
POST
/v1/robots/raw/media/{mediaId}/complete
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.

mediaId
required
string

Id returned by mint.

Example

62bc5e66-8e11-4940-a70d-22efc1979674
Media typeapplication/json
object
partnerId
required

Partner id. It must match the server key.

string
schemaVersion
required

Schema version of this body. Example: 2026-11.

string
sourceSystem
required

Name of the system that sent this body. Example: partner-export.

string

Example

{
"partnerId": "partner",
"schemaVersion": "2026-11",
"sourceSystem": "partner-export"
}

File is live. status is ready. A repeat on a ready file is 200 with status ready.

Media typeapplication/json
object
mediaId
required
string
status
required

ready means the file is live.

string
Allowed values: ready

Example

{
"mediaId": "62bc5e66-8e11-4940-a70d-22efc1979674",
"status": "ready"
}
400A required field is missing.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "invalid_body"
}
401The server key is missing or wrong.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

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.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "forbidden"
}
404Unknown `mediaId`. Nothing is stored.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "not_found"
}
409No completed object is available yet. Upload before the credential expires and retry complete.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "upload_incomplete"
}
410The 24-hour completion deadline has expired. Mint again; a previous ready map is unchanged.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

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.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "invalid_media"
}
503Storage or its required configuration is unavailable. Retry after the Retry-After interval.
Media typeapplication/json
object
error
required

Stable error code. No stack trace.

string

Example

{
"error": "unavailable"
}