Update Collection Items

PATCH /collections/{collection_id}/items

Copy endpoint

https://api.webflow.com/v2

Update a single item or multiple items in a Collection.

The limit for this endpoint is 100 items.

Items will only be updated in the primary locale, unless a cmsLocaleId is included in the request.

Required scope | CMS:write

Parameters

path Path Parameters

Name	Type
`collection_id` required Unique identifier for a Collection	string

query Query Parameters

Name	Type
`skipInvalidFiles` When true, invalid files are skipped and processing continues. When false, the entire request fails if any file is invalid.	boolean

Request Body

application/json

Details of the item to update

{ items?: {
id: string;
cmsLocaleId?: string;
lastPublished?: string;
lastUpdated?: string;
createdOn?: string;
isArchived?: boolean;
isDraft?: boolean;
fieldData?: { name?: string;slug?: string; };
}[]; }

Responses

200 application/json

Request was successful

{ items?: {
id: string;
cmsLocaleId?: string;
lastPublished: string;
lastUpdated: string;
createdOn: string;
isArchived?: boolean;
isDraft?: boolean;
fieldData: { name: string;slug: string; };
}[];pagination?: { limit?: number;offset?: number;total?: number; }; }

Client Errors

400 application/json

Request body was incorrectly formatted.

{
code?: "bad_request" | "collection_not_found" | "conflict" | "duplicate_collection" | "duplicate_user_email" | "ecommerce_not_enabled" | "forbidden" | "forms_require_republish" | "incompatible_webhook_filter" | "internal_error" | "invalid_auth_version" | "invalid_credentials" | "invalid_domain" | "invalid_user_email" | "item_not_found" | "missing_scopes" | "no_domains" | "not_authorized" | "not_enterprise_plan_site" | "not_enterprise_plan_workspace" | "order_not_found" | "resource_not_found" | "too_many_requests" | "unsupported_version" | "unsupported_webhook_trigger_type" | "user_limit_reached" | "user_not_found" | "users_not_enabled" | "validation_error";
message?: string;
externalReference?: string;
details?: unknown[];
}

401 application/json

Provided access token is invalid or does not have access to requested resource

404 application/json

Requested resource not found

429 application/json

The rate limit of the provided access_token has been reached. Please have your application respect the X-RateLimit-Remaining header we include on API responses.

Server Errors

500 application/json

We had a problem with our server. Try again later.