Comentarios

List the comments of an article

knowledge_base.comments.list

Lists the comments of a Knowledge Base article, oldest first, paginated by cursor: content (sanitized HTML, or plain text in old comments), content_text (plain text), mentioned user ids, author and dates (edited_at when the author edited it). Not found (kb_item_not_found) if the article does not exist or the caller cannot see it. Requires view access to the Knowledge Base.

Alcance

knowledge_base:read

Permiso

Ver el módulo

Tool del MCP

knowledge_base_comments_listEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.comments.list".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Comment on an article

knowledge_base.comments.create

Adds a comment to a Knowledge Base article as the caller: content is HTML (sanitized: formatting, links and mention chips survive, scripts do not) or plain text, up to 10,000 characters. mentions are user ids to notify in the app: only people with access to the organization who can also see the article get the notice (the others are ignored, so a private article never leaks to someone who cannot open it). Returns the new comment. Requires full access to the Knowledge Base.

Alcance

knowledge_base:write

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_comments_createEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.comments.create".

Costo declarado: hasta 5 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/knowledge-base/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'

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/knowledge-base/items/{item_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'

Edit a comment

knowledge_base.comments.update

Replaces the content of a comment on a Knowledge Base article; it is marked as edited. Only its author can edit it (403 comment_author_only). mentions replaces the mentioned ids (without it, the previous ones stay); only newly added mentions are notified, and only to people who can see the article. Returns the comment. Requires full access.

Alcance

knowledge_base:write

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_comments_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.comments.update".

Costo declarado: hasta 5 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/knowledge-base/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'

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/knowledge-base/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'

Delete a comment

knowledge_base.comments.delete

Deletes a comment of a Knowledge Base article. Its author can always delete it; an owner or admin can delete anyone's (403 comment_delete_denied otherwise). It stays 30 days in the trash. Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete.

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

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

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_comments_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.comments.delete".

Costo declarado: hasta 3 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/knowledge-base/items/{item_id}/comments/{comment_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/knowledge-base/items/{item_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"