List labels in use

GEThttps://anjal.app/v1/messages/labels

Every label in use, with how many threads carry it. Same scoping as GET /v1/messages.

Query parameters

inboxId

string

Limit to one inbox.

Responses

200application/jsonOK

`labels` object[]
`label` string
`threads` integer

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { Anjal } from "anjal";

const client = new Anjal({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/messages/labels
const result = await client.request("get", "/v1/messages/labels");

Example response · 200

{
  "labels": [
    {
      "label": "needs-review",
      "threads": 4
    }
  ]
}