Menu

Referência da API · Atividade

Etiquetas

activity · labels · 1 operação

GET/v1/activity/labels

List activity labels

activity.labels.list

LeituraIdempotenteDesde 2026-11-01

Lists the organization's activity labels (id, name, color) in their manual order, paginated by cursor (limit up to 200), to set label_ids on entries (activity.entries.create and update ignore ids that are not here). Every label comes, ordered by order ascending: a label saved without a position counts as 0 (and comes back with order 0), and ties go by id. That holds up to 200 labels; an organization with more is listed by its stored position, and a label without one is left out. Labels are created, edited and deleted in the app. An Account has its own labels. Cost: one read per label of the organization (up to 200) plus one.

Escopo
activity:read
Permissão
Ver o módulo
Tool do MCP
activity_labels_listNa superfície completa; na compacta, mb_execute_operation com id: "activity.labels.list".

Custo declarado: até 203 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Padrão: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

Resposta

dataarray<object>
has_moreboolean
next_cursorstring

Erros

Exemplo

curl "https://api.mb-suite.com/v1/activity/labels" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/activity/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"