Tags

List Knowledge Base tags

knowledge_base.tags.list

Lists the tags used to classify Knowledge Base articles (name, hex color, order), in the order the app shows them, up to 200. Use their ids in tag_ids when creating or updating articles, in knowledge_base.items.bulk.update_tags, and to filter knowledge_base.items.list by tag_id. Requires view access to the Knowledge Base.

Alcance

knowledge_base:read

Permiso

Ver el módulo

Tool del MCP

knowledge_base_tags_listEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.tags.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/knowledge-base/tags" \
  -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/tags" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a Knowledge Base tag

knowledge_base.tags.create

Creates a tag with a name (up to 100 characters) and a hex color (#rrggbb or #rgb), placed last in the order. Names do not repeat inside an organization, ignoring case and accents: an existing name is 409 kb_tag_name_taken with existing_tag_id (use that tag). Up to 200 tags per organization (409 limit_reached, details.resource kb_tags). Returns the tag with its id. Requires full access to the Knowledge Base.

Alcance

knowledge_base:write

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_tags_createEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.tags.create".

Costo declarado: hasta 201 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/knowledge-base/tags" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "color": "COLOR"
}'

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/tags" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME",
  "color": "COLOR"
}'

Rename, recolor or move a Knowledge Base tag

knowledge_base.tags.update

Changes the name, the color (#rrggbb or #rgb) or the position (order) of a tag, sent inside updates; the articles that have it keep it. A name already used by another tag is 409 kb_tag_name_taken. Idempotent: sending what the tag already has changes nothing (changed: false). Returns the tag. Requires full access.

Alcance

knowledge_base:write

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_tags_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.tags.update".

Costo declarado: hasta 202 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/tags/{tag_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/knowledge-base/tags/{tag_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a Knowledge Base tag

knowledge_base.tags.delete

Deletes a tag and removes it from every article that has it (the articles themselves are not touched otherwise). The tag stays 30 days in the trash; restoring it brings the tag back and puts it back on all the articles that had it and still exist. Up to 5,000 articles: with more, the deletion stops before writing anything with 409 too_many_tagged_articles (delete it from the app). Returns how many articles were updated. Outside the app it needs a dry run (which counts the articles) 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

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

Permiso

Editar en el módulo

Tool del MCP

knowledge_base_tags_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "knowledge_base.tags.delete".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/knowledge-base/tags/{tag_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/tags/{tag_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"