Base URL
https://app.dmu.email/api/v1
Authentication
Bearer dmk_… API key
Rate limit
120 requests a minute per key

List a thread’s labels

GET/threads/{id}/labels

Returns the labels on one conversation.

Needs the permissionthreads:read

Path parameters

idstringrequired
The thread.

Returns

A list of labels, each with:

idstring
The label.
namestring
Its name.
colourstring
A preset such as blue-700.

Errors

401invalid_key
The key is wrong, expired or revoked. With no Authorization header at all, the code is missing_credentials.
403missing_scope
The key doesn’t have threads:read. The X-Required-Scope header names what’s missing.
404not_found
There’s no such thread, or the key’s owner can’t see it.
429rate_limited
More than 120 requests a minute from this key. Wait for Retry-After seconds.
curl https://app.dmu.email/api/v1/threads/a41c93f0/labels \
  -H "Authorization: Bearer dmk_7f3a9c2e1b4d_Xq8v…"

Response

200 OK

{
  "data": [
    {
      "id": "5b0e2c71",
      "name": "Invoices",
      "colour": "blue-700"
    }
  ]
}

Every response wraps its result in data. A page of threads adds nextCursor, which is null on the last page.