Etiquetas

List member labels

members.labels.list

Lists the organization's member labels in display order (name, color, order): tags that organize the team on the Members page and filter members.members.list (label_id). They do not change access. Requires view access to Members.

Alcance

members:read

Permiso

Ver el módulo

Tool del MCP

members_labels_listEn la superficie completa; en la compacta, mb_execute_operation con id: "members.labels.list".

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

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/members/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/members/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a member label

members.labels.create

Creates a member label with a name (up to 80 characters) and an optional hex color (without it, the next color of the app's palette). It goes last in the order. Put it on members with members.members.update_labels or members.members.bulk.update_labels. Returns the label. Owner or admin only.

Alcance

members:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_labels_createEn la superficie completa; en la compacta, mb_execute_operation con id: "members.labels.create".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/members/labels" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

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 -X POST "https://api.mb-suite.com/v1/members/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Update a member label

members.labels.update

Updates a member label's name, color or position in the list, all inside updates: order is the position (0 = first; past the end = last) and the other labels shift to make room. Unknown fields are rejected. 404 member_label_not_found if it is not in this organization. Returns the label. Owner or admin only.

Alcance

members:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_labels_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "members.labels.update".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/members/labels/{label_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

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 -X PATCH "https://api.mb-suite.com/v1/members/labels/{label_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a member label

members.labels.delete

Deletes a member label and removes it from every member that had it, in one write. The label stays 30 days in the trash, where an owner or admin can restore it (platform.trash.restore); restoring puts it back on those members (the ones still in the organization). Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. 404 member_label_not_found. Owner or admin only.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance

members:write y «Permitir eliminar» (members:delete en OAuth)

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_labels_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "members.labels.delete".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/members/labels/{label_id}" \
  -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 -X DELETE "https://api.mb-suite.com/v1/members/labels/{label_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"