Conversation Labels

Apply labels to conversations

Add label to conversation

post

Add a label to a specific conversation. There is not currently an API endpoint for listing conversations, but you can use our Webhook facility to be notified of new conversations and new messages automatically, and these will include the conversation ID required to use this API endpoint.

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

Path parameters

conversation_idstringRequired

ID of the conversation. This will often be in the form of a “slug”, e.g. hows-the-weather-today-4bg2

Example: my-bug

Body

application/json

label_idintegerRequired

ID of the label to apply

Example: 456

Responses

201

Label applied successfully

application/json

401

Missing or invalid API token

application/json

404

Resource or endpoint not found

application/json

422

Validation errors

application/json

500

Internal server error

application/json

post

/conversations/{conversation_id}/labels

HTTPcURLJavaScriptPython

POST /api/conversations/{conversation_id}/labels HTTP/1.1
Host: app.letsjelly.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "label_id": 456
}

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