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.

Alcance

social_inbox:read

Permiso

Ver el módulo

Tool del MCP

social_inbox_notes_listEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.notes.list".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Alcance

social_inbox:write

Permiso

Editar en el módulo

Tool del MCP

social_inbox_notes_addEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.notes.add".

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

Parámetros

Respuesta

Errores

Ejemplo

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

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

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_notes_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "social_inbox.notes.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/social-inbox/items/{item_id}/notes/{note_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/items/{item_id}/notes/{note_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"