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.

Escopo

social_planner:read

Permissão

Ver o módulo

Tool do MCP

social_planner_labels_listNa superfície completa; na compacta, mb_execute_operation com id: "social_planner.labels.list".

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

Parâmetros

Sem parâmetros.

Resposta

Erros

Exemplo

curl "https://api.mb-suite.com/v1/social-planner/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/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.

Escopo

social_planner:write

Permissão

Editar no módulo

Tool do MCP

social_planner_labels_createNa superfície completa; na compacta, mb_execute_operation com id: "social_planner.labels.create".

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

Parâmetros

Resposta

Erros

Exemplo

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"
}'

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

Escopo

social_planner:write

Permissão

Editar no módulo

Tool do MCP

social_planner_labels_updateNa superfície completa; na compacta, mb_execute_operation com id: "social_planner.labels.update".

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

Parâmetros

Resposta

Erros

Exemplo

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": {}
}'

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

Escopo

social_planner:write

Permissão

Editar no módulo

Tool do MCP

social_planner_labels_reorderNa superfície completa; na compacta, mb_execute_operation com id: "social_planner.labels.reorder".

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

Parâmetros

Resposta

Erros

Exemplo

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"
  ]
}'

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

Com uma API key, este DELETE roda direto: o registro fica 30 dias na lixeira e a resposta traz o seu trash_item_id. Com um token OAuth, e pelo MCP, pede dry_run → confirm_token.

Escopo

social_planner:write e «Permitir exclusões» (social_planner:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

social_planner_labels_deleteNa superfície completa; na compacta, mb_execute_operation com id: "social_planner.labels.delete".

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

Parâmetros

Resposta

Erros

Exemplo

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