OMomniapp
Labels

Create a label

post/api/v1/labels

Request

  • Base URL
    https://omniapp.co (the document declares no server; this is the origin it was published from)
  • URL
    https://omniapp.co/api/v1/labels
  • Auth
    HTTP bearer

Query parameters

userIdstring uuid

Target user ID (for org-scoped API keys)

Request body

colorstring nullable

Hex color for the label (e.g. #0366d6)

descriptionstring nullable

Label description

homepageboolean

Show label on homepage. Requires admin permissions.

namestring required

Label name

verifiedboolean

Mark as verified label. Requires admin permissions.

Example request

{
  "color": "#0366d6",
  "description": "Important items that need attention",
  "name": "important"
}

Response

Label created successfully

colorstring nullable required

Hex color for the label (e.g. #0366d6)

descriptionstring nullable required

Label description

homepageboolean required

Whether label is shown on homepage

namestring required

Label name

usage_countnumber required

Number of documents with this label

verifiedboolean required

Whether label is verified

Example response

{
  "color": "#0366d6",
  "description": "Important items that need attention",
  "name": "verified"
}

Changes

No recorded changes to this operation across all 97 revisions of this API.