Docmost Octri Preview
POST/pages/update-verification

Update a page's verification settings

Updates verification settings for a page, including its expiry mode and assigned verifiers. Supply pageId; when setting a period or fixed expiry mode, provide the corresponding period fields or future expiry date.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields

Page verification settings to update; expiry fields depend on the selected mode.

fixedExpiresAtstringoptional
Required with `mode: fixed`. Must be a future date.
modestringoptional
Expiry mode: `period`, `fixed`, or `indefinite`.
Allowed:periodfixedindefinite
pageIdstringrequired
UUID of the page whose verification settings to update.
periodAmountintegeroptional
Required with `mode: period`, alongside `periodUnit`. The effective cap depends on `periodUnit` - 3650 days, 520 weeks, 120 months, or 20 years.
periodUnitstringoptional
Required with `mode: period`, alongside `periodAmount`.
Allowed:dayweekmonthyear
verifierIdsarray<string>optional
UUIDs of the assigned verifiers. If provided, the array must contain between 1 and 5 items.

3 status codes
200Returns the updated page verification settings in the response data.
dataobjectoptional
statusintegeroptional
successbooleanoptional
400Returned when the request fails validation, including missing `pageId` or invalid or incompatible verification settings.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Returned when access is forbidden or an enterprise licence is required.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned when pageId is missing or the verification settings fail validation. mode must be period, fixed, or indefinite; period mode requires periodAmount and periodUnit, and fixed mode requires a future fixedExpiresAt. A 403 is returned when access is forbidden or an enterprise licence is required.