Labels

Create a label

post/label

Request

Base URL: https://test.boost.space/api
URL: https://test.boost.space/api/label
Auth: HTTP bearer

Request body

idinteger

Unique identifier - primary key

createdstring date-time

Creation timestamp

createdUserIdinteger

ID of user who created this record

updatedstring date-time

Last updated timestamp

updatedUserIdinteger

ID of user who last updated this record

spacesobject

Spaces this label is assigned to, and the optional per-space module restriction. Keys are space IDs; each value is an array of module names (in dash syntax) the label may be attached to within that space, or an empty array / null to allow all modules in that space. An empty spaces object makes the label global - visible to every space and every user.

namestring required

Name of this label

colorstring required

Color of this label

typestring

Scope of this label. SHARED labels are visible to all users with access to the assigned spaces; a SHARED label with no spaces is global and visible to everyone.

modulestring

Name of the module this label can be attached to. When set, the label can only be attached to records of this module. Leave empty to allow any module (subject to per-space restrictions in spaces).

editableboolean

Determines if label can be edited by currently logged user

Example request

{
  "id": 42,
  "created": "2026-01-15T09:30:00Z",
  "createdUserId": 42,
  "updated": "2026-01-15T09:30:00Z",
  "updatedUserId": 42,
  "spaces": {
    "12": [
      "contact",
      "todo"
    ],
    "34": []
  },
  "name": "Sample name",
  "color": "#1f6feb",
  "type": "string",
  "module": "string",
  "editable": true
}

Response

Label - Created record