Update collection

put

https://api.duda.co/api/integrationhub/application/site/{site_name}/collection/{collection_name}

Update an existing collection

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Only the collection settings can be updated with this endpoint. Updating a field of a collection can be done with the Fields API documented below
For detailed request and response body specifications, please refer to the Partner API reference documentation here.

Path Params

site_name

string

required

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

collection_name

string

required

The collection's name.

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

500

Internal error in the Integration Hub. The body is empty.

Only the collection settings can be updated with this endpoint. Updating a field of a collection can be done with the Fields API documented below

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

401Unauthorized. The credentials are missing or invalid.

403The access token does not grant access to this site or operation.

429Too many requests. The rate limit was exceeded.