Etiquetas

List Social Inbox labels

social_inbox.labels.list

Lists the labels used to tag inbox items (name, hex color, order), in the order the inbox shows them (up to 200). Use their ids with social_inbox.items.set_labels, in rules (add_labels) and to filter social_inbox.items.list (label_id). Requires view access to the Social Inbox.

Alcance

social_inbox:read

Permiso

Ver el módulo

Tool del MCP

social_inbox_labels_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.labels.list".

Costo declarado: hasta 200 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/social-inbox/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/social-inbox/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a Social Inbox label

social_inbox.labels.create

Creates an inbox label with a name (up to 80 characters) and a hex color (#rrggbb; default red), placed last in the order. An organization (workspace or account) has up to 200 (409 limit_reached, details.resource inbox_labels). Returns the label with its id. Requires full access and an owner, admin or member role.

Alcance

social_inbox:write

Permiso

Editar en el módulo

Tool del MCP

social_inbox_labels_createEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.labels.create".

Costo declarado: hasta 2 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/social-inbox/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/social-inbox/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Rename or recolor a Social Inbox label

social_inbox.labels.update

Updates the name and/or the hex color (#rrggbb) of an inbox label; only what comes in updates changes, and the items that have it keep it. 404 inbox_label_not_found if it does not exist. Returns the label. Requires full access and an owner, admin or member role.

Alcance

social_inbox:write

Permiso

Editar en el módulo

Tool del MCP

social_inbox_labels_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.labels.update".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Delete a Social Inbox label

social_inbox.labels.delete

Deletes an inbox label and removes it from the items that have it (up to 500 per call). It stays 30 days in the trash; restoring it brings the label back with the same id and puts it back on those items (the ones deleted meanwhile are skipped). Rules that add it (add_labels) keep adding it to new items while it is in the trash, where it does not show: the dry run lists them (counts.rules and a warning). Outside the screen it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. Returns how many items were updated. Requires full access and an owner, admin or member role.

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

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

Permiso

Editar en el módulo

Tool del MCP

social_inbox_labels_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.labels.delete".

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

Parámetros

Respuesta

Errores

Ejemplo

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