Menú

Referencia de la API · Tareas

Comentarios

task_management · comments · 4 operaciones

GET/v1/tasks/{task_id}/commentsList the comments of a task POST/v1/tasks/{task_id}/commentsComment on a task PATCH/v1/tasks/{task_id}/comments/{comment_id}Edit a comment DELETE/v1/tasks/{task_id}/comments/{comment_id}Delete a comment

GET/v1/tasks/{task_id}/comments

List the comments of a task

task_management.comments.list

LecturaIdempotenteDesde 2026-11-01

Lists the comments of a task, oldest first, paginated by cursor: content (sanitized HTML, or plain text in old comments), content_text (plain text), mentions, author and dates (edited_at when the author edited it). Not found if the task does not exist or the caller cannot see it.

Alcance: task_management:read
Permiso: Ver el módulo
Tool del MCP: task_management_comments_listEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.comments.list".

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

Parámetros

task_idstringrutarequerido

The task's id (from task_management.tasks.list, or the task_id that tasks.create returns).

limitintegerqueryopcional

Rows per page (1 to 200; default 50).

Por defecto: 50

cursorstringqueryopcional

The next_cursor of the previous page, to continue the list; omit it for the first page.

Respuesta

dataarray<object>

has_moreboolean

next_cursorstring

Errores

task_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

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

POST/v1/tasks/{task_id}/comments

Comment on a task

task_management.comments.add

EscrituraDesde 2026-11-01

Adds a comment to a task 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 of people with access to the organization: each one gets an in-app notification linking to the task (other ids are ignored). Returns the new comment.

Alcance: task_management:write
Permiso: Editar en el módulo
Tool del MCP: task_management_comments_addEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.comments.add".
Eventos que puede emitir: task_management.comment.added

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

Parámetros

task_idstringrutarequerido

The task's id (from task_management.tasks.list, or the task_id that tasks.create returns).

contentstringcuerporequerido

HTML (sanitized) or plain text, up to 10,000 characters.

mentionsarray<string>cuerpoopcional

People mentioned (uids of members, members.members.list): each gets a notice in the app.

Respuesta

comment_idstring

commentobject

Errores

task_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/{task_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/tasks/{task_id}/comments" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "content": "CONTENT"
}'

PATCH/v1/tasks/{task_id}/comments/{comment_id}

Edit a comment

task_management.comments.edit

EscrituraDesde 2026-11-01

Replaces the content (and mentions) of a comment; it is marked as edited. Only its author can edit it (403 comment_author_only otherwise). Only newly added mentions are notified. Returns the edited comment.

Alcance: task_management:write
Permiso: Editar en el módulo
Tool del MCP: task_management_comments_editEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.comments.edit".

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

Parámetros

task_idstringrutarequerido

The task's id (from task_management.tasks.list, or the task_id that tasks.create returns).

comment_idstringrutarequerido

The comment's id (from task_management.comments.list).

contentstringcuerporequerido

HTML (sanitized) or plain text, up to 10,000 characters.

mentionsarray<string>cuerpoopcional

People mentioned (uids of members, members.members.list): each gets a notice in the app.

Respuesta

commentobject

Errores

task_not_found invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/tasks/{task_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/tasks/{task_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "CONTENT"
}'

DELETE/v1/tasks/{task_id}/comments/{comment_id}

Delete a comment

task_management.comments.delete

IrreversibleDesde 2026-11-01

Deletes a comment of a task. 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: task_management:write y «Permitir eliminar» (task_management:delete en OAuth)
Permiso: Editar en el módulo
Tool del MCP: task_management_comments_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "task_management.comments.delete".

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

Parámetros

task_idstringrutarequerido

The task's id (from task_management.tasks.list, or the task_id that tasks.create returns).

comment_idstringrutarequerido

The comment's id (from task_management.comments.list).

Respuesta

oktrue

trash_item_idstring

The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.

trash_item_idsarray<string>

Only when the deletion left more than one copy: all of them, the first being trash_item_id.

trash_expires_atnumber

When the copy leaves the trash for good (epoch ms): 30 days after the deletion.

Errores

task_not_found delete_not_allowed confirmation_required invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/tasks/{task_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/tasks/{task_id}/comments/{comment_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"