Add collection to the site

post

https://api.duda.co/api/sites/multiscreen/{site_name}/collection

Creates a new collection for the site.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
External endpoint content type
The URL specified in the external_endpoint property of the external details object, must return a Content-Type header set to application/json other content types will cause an error when creating the collection.

🚧
Maximum data limit
A single external collection endpoint cannot exceed 20MB of data.

Path Params

site_name

string

required

The site's unique name (its ID), returned when the site is created.

Body Params

base_refresh_interval

string | null

Configured frequency for automatic external collection data refresh.

customer_lock

string

enum

Lock state for customer editing. Supported values:

'unlocked' - customers have no limitations for editing collection fields or data. null value in response is equivalent to 'unlocked' state
'structure_locked' - customers can't edit, add or remove collection fields
'view_only' - customers can't edit fields and internal collection data
Following logic & limitations is applied in create/update requests:
null value will not change collection lock state
image collections can only be locked for 'view_only' state
external collections can only be locked for 'structure_locked' state

Allowed:

external_details

object

fields

array of objects

fields

item_count

int32

name

string

regular_page_bindable

boolean

Whether collection is bindable to non-dynamic pages. See feature support article for more details: https://support.duda.co/hc/en-us/articles/26519925982487-Dynamic-Content-Collections-for-Regular-Pages

static_page_bindable

boolean

deprecated

values

array of objects

values

Responses

200

External endpoint content type

Maximum data limit

400Bad request. The request is malformed or failed validation.

401Unauthorized. The credentials are missing or invalid.

429Too many requests. The rate limit was exceeded.