Labels

Labels help you and your team quickly identify and filter conversations. This API allows you to create labels automatically.

List labels

get

Get all labels for your team, ordered by name

Authorizations

BearerAuth

AuthorizationstringRequired

API token authentication. Include your token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

To get an API token:

1. Go to your team settings in Jelly
2. Navigate to "API Tokens"
3. Create a new token and save it securely

Responses

200

Successful response

application/json

401

Missing or invalid API token

application/json

500

Internal server error

application/json

get

/labels

HTTPcURLJavaScriptPython

GET /api/labels HTTP/1.1
Host: app.letsjelly.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "Bug",
    "color": "cherry"
  },
  {
    "id": 2,
    "name": "Feature",
    "color": "mint"
  }
]

Create label

post

Create a new label for your team

Authorizations

BearerAuth

AuthorizationstringRequired

API token authentication. Include your token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

To get an API token:

1. Go to your team settings in Jelly
2. Navigate to "API Tokens"
3. Create a new token and save it securely

Body

application/json

namestringRequired

Label name

Example: Important

colorstring · enumRequired

Label color

Example: cherryPossible values:

Responses

200

Label created successfully

application/json

401

Missing or invalid API token

application/json

422

Validation errors

application/json

500

Internal server error

application/json

post

/labels

HTTPcURLJavaScriptPython

POST /api/labels HTTP/1.1
Host: app.letsjelly.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "name": "Important",
  "color": "cherry"
}

{
  "id": 3,
  "name": "Important",
  "color": "cherry"
}