Core concepts
Permissions and scopes
Grant the smallest set of immutable permissions required by each integration.
Available scopes
| Scope | Endpoints |
|---|---|
screens:read | GET /screens, GET /screens/{screenId} |
playback:read | GET /screens/{screenId}/configuration |
playlists:read | GET /playlists and playlist item routes |
media:read | GET /media, GET /media/{mediaId} |
Independent enforcement
Scopes do not imply one another. A playback-only credential can resolve a known screen ID without browsing the screen inventory. A screens-only credential cannot retrieve playback content.
GET
/api/partner/v1/screens/{screenId}/configuration
playback:read
Changing permissions
Scopes cannot be edited. Create a replacement credential, migrate the integration, then revoke the old credential. See Credential rotation.