Skip to content

MediaSonosNativeIdentity

HTTP API schema

Observed Sonos music-service coordinates for the current item, scoped to the reporting route and authorized connection. This identity is not a portable catalog ID, playable URL or authorization to play content. Preserve opaque values exactly; do not decode or log them.

MediaSonosNativeIdentity fields

integrationstringRequired

Integration defining this native identity format, independent of the source catalog provider.

Allowed values

  • SONOS
serviceIdstring

Exact service identifier reported by Sonos, when present.

minLength: 1

maxLength: 20

pattern: "^[^\\x00-\\x1F\\x7F-\\x9F]+$"

objectIdstringRequired

Exact opaque content identifier reported by Sonos, including its original case and percent escapes.

minLength: 1

maxLength: 256

pattern: "^[^\\x00-\\x1F\\x7F-\\x9F]+$"

accountIdstring

Exact Sonos music-service account coordinate, when present. This is not a credential and must not authorize subsequent playback by itself.

minLength: 1

maxLength: 13

pattern: "^[^\\x00-\\x1F\\x7F-\\x9F]+$"

View source specification ↗