Notas internas

List the internal notes of a Social Inbox item

social_inbox.notes.list

Lists the internal notes the team left on an inbox item (author, text, mentions), oldest first, up to 200. Notes never go to the network. 404 inbox_item_not_found if the item is not in this organization. Requires view access to the Social Inbox.

Escopo

social_inbox:read

Permissão

Ver o módulo

Tool do MCP

social_inbox_notes_listNa superfície completa; na compacta, mb_execute_operation com id: "social_inbox.notes.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Add an internal note to a Social Inbox item

social_inbox.notes.add

Adds an internal note (up to 4,096 characters) to an inbox item, visible only to the team; it is never sent to the network. mentions are user ids of members of the organization (others are dropped). Returns the note and its id. Requires full access and an owner, admin or member role.

Escopo

social_inbox:write

Permissão

Editar no módulo

Tool do MCP

social_inbox_notes_addNa superfície completa; na compacta, mb_execute_operation com id: "social_inbox.notes.add".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/social-inbox/items/{item_id}/notes" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "text": "TEXT"
}'

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-inbox/items/{item_id}/notes" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "text": "TEXT"
}'

Delete an internal note of a Social Inbox item

social_inbox.notes.delete

Deletes an internal note of an inbox item (any owner, admin or member of the team can). It stays 30 days in the trash. 404 inbox_note_not_found if the note is not on that item. Outside the screen it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. 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_inbox:write e «Permitir exclusões» (social_inbox:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

social_inbox_notes_deleteNa superfície completa; na compacta, mb_execute_operation com id: "social_inbox.notes.delete".

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

Parâmetros

Resposta

Erros

Exemplo

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