Docmost Octri Preview
POST/pages/labels/add

Apply labels to a page

Labels are created on demand and matched case-insensitively.

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

2 body fields
namesarray<string>required
Label names. Normalised to lowercase, and created if they do not exist yet.
pageIdstringrequired
Page identifier.

4 status codes
200Labels applied
dataarray<object>optional
statusintegeroptional
successbooleanoptional
400Invalid label name
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Forbidden
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
404Page not found
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned: Invalid label name. A 403 is returned: Forbidden. A 404 is returned: Page not found.