Docs

Add Content Block

POST /surfaces/{surfaceId}/contentBlocks

POST/surfaces/{surfaceId}/contentBlocks

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.

Schedules a content item onto a surface for a specific time window. A surface can have multiple non-overlapping content blocks.

Path Parameters

FieldTypeRequiredDescription
surfaceIdGuidRequiredThe ID of the surface to schedule content on. Replace `{{surfaceId}}` in the URL.

Request Body

FieldTypeRequiredDescription
contentIdGuidRequiredID of the content item to schedule on this surface.
startTimeDateTimeRequiredStart of the display window (ISO 8601).
endTimeDateTimeRequiredEnd of the display window (ISO 8601).

Response

Returns 201 Created with an empty body on success.