Etiquetas · Actividad · Referencia de la API

GET/v1/activity/labels

List activity labels

activity.labels.list

LecturaIdempotenteDesde 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.

Alcance: activity:read
Permiso: Ver el módulo
Tool del MCP: activity_labels_listEn la superficie completa; en la compacta, mb_execute_operation con id: "activity.labels.list".

Costo declarado: hasta 203 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

limitintegerqueryopcional

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

Por defecto: 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.

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

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

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

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