Documents

Create a label

Adds a label to the archive’s taxonomy. Nest it under an existing one with parent_id (from documents_list_labels) — up to three levels deep. This does not label any document — call documents_set_labels afterwards.

post/api/v1/rest/documents/labels

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/documents/labels
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

namestring required
color'slate' | 'red' | 'amber' | 'green' | 'teal' | 'blue' | 'violet' | 'pink'
parent_idstring uuid nullable

Nest under this label. Omit for the top level.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.