API guide

Playback configuration

Read a stable, allowlisted projection of the effective content a screen should present.

Resolve configuration

GET /api/partner/v1/screens/{screenId}/configuration playback:read

Configuration uses its own permission. A credential does not need screens:read if it already knows the screen ID.

curl --url "https://api.signagewall.com/api/partner/v1/screens/$SCREEN_ID/configuration" \
  --header "Authorization: Bearer $SIGNAGEWALL_PARTNER_API_KEY"

Response model

The response includes resolution time, revision, minimal screen presentation, availability, ordered playback items, and overlays. Image and video items expose only approved playback metadata and an opaque public URL when allowed.

Internal resolverPartner mapperPartner v1 DTO

The controller only receives the Partner-owned DTO. The internal player object is never returned directly.

Applications and Zones

Applications use a default-deny projection registry. Unknown applications contain only safe generic identity, duration, and rendering metadata. Arbitrary app configuration and resolved integration data remain private.

Zones geometry uses normalized values from 0 to 1 for x, y, width, and height. It does not expose the internal grid scale or template representation.

URL policy

V1 returns approved public playback URLs only. Private or unexpected signed URLs are omitted. Treat every returned URL as an opaque, short-lived resource location whose host and storage implementation can change.