Etiquetas

List post labels

social_planner.labels.list

Lists the labels used to tag Social Planner posts (name, hex color, order), in the order the planner shows them (up to 200). Use their ids in label_ids when creating or updating posts and to filter social_planner.posts.list. Requires view access to the Social Planner.

Alcance

social_planner:read

Permiso

Ver el módulo

Tool del MCP

social_planner_labels_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.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-planner/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-planner/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a post label

social_planner.labels.create

Creates a post label with a name (up to 50 characters) and a hex color (#rrggbb; default #ef4444, the first of the palette), placed last in the order (the first label is 0). Labels are per organization (workspace or account), up to 200 (409 limit_reached, details.resource post_labels). Returns the label with its id. Requires full access to the Social Planner.

Alcance

social_planner:write

Permiso

Editar en el módulo

Tool del MCP

social_planner_labels_createEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.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/social-planner/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-planner/labels" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Rename, recolor or move a post label

social_planner.labels.update

Updates the name, the color (#rrggbb) or the position (order) of a post label; posts that use it keep it. Returns the updated label. Requires full access.

Alcance

social_planner:write

Permiso

Editar en el módulo

Tool del MCP

social_planner_labels_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.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-planner/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-planner/labels/{label_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Reorder post labels

social_planner.labels.reorder

Sets the order of post labels: label_ids in the new order (position = index). Ids that are not labels of this organization (another tab deleted one) are skipped and counted in skipped; repeated ids are 400 duplicate_label_ids. Returns count (reordered) and skipped. Requires full access.

Alcance

social_planner:write

Permiso

Editar en el módulo

Tool del MCP

social_planner_labels_reorderEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.labels.reorder".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/social-planner/labels/reorder" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "label_ids": [
    "LABEL_ID"
  ]
}'

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-planner/labels/reorder" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "label_ids": [
    "LABEL_ID"
  ]
}'

Delete a post label

social_planner.labels.delete

Deletes a post label and removes it from every post that has it (the posts themselves are not touched otherwise). The label goes to the 30-day trash; restoring it brings the label back but not its assignments to posts. The dry run says how many posts have it. Returns how many posts were updated. Requires full access.

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_planner:write y «Permitir eliminar» (social_planner:delete en OAuth)

Permiso

Editar en el módulo

Tool del MCP

social_planner_labels_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "social_planner.labels.delete".

Costo declarado: hasta 501 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-planner/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-planner/labels/{label_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"