Packs

List task packs

task_management.packs.list

Lists task packs (reusable lists of tasks with deadlines relative to an anchor date) in their manual order, paginated by cursor: the organization's own (source org, default) or the published templates of the MB Suite library (source system), which can be applied directly or cloned into the organization. A pack carries name, description, color, labels and item_count; its tasks are in task_management.packs.items.list. Every pack of the organization comes, ordered by order ascending: a pack saved without a position (older packs) counts as 0 and comes back with order 0, and ties go by id. That holds up to 200 packs; an organization with more is listed by its stored position, and a pack without one is left out. Cost: the organization's packs are read whole (one read per pack, up to 200, plus one); the library, one read per pack of the page.

Escopo

task_management:read

Permissão

Ver o módulo

Tool do MCP

task_management_packs_listNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Get one task pack

task_management.packs.get

Returns one task pack: the organization's, or a published one of the MB Suite library (is_system_pack). Without source it looks in the organization first and then in the library. Its tasks are in task_management.packs.items.list.

Escopo

task_management:read

Permissão

Ver o módulo

Tool do MCP

task_management_packs_getNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.get".

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

Parâmetros

Resposta

Erros

Exemplo

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

List the tasks of a pack

task_management.packs.items.list

Lists the items of a task pack in order: title, description, days_offset (days from the anchor date when applied; negative, zero or positive), priority, subtasks and recurrence. Works for the organization's packs and the published library packs.

Escopo

task_management:read

Permissão

Ver o módulo

Tool do MCP

task_management_packs_items_listNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.items.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Create a task pack

task_management.packs.create

Creates an empty task pack at the end of the organization's list, owned by the caller: name, optional description, color (hex, default #3b82f6) and pack labels (unknown label ids are ignored). Add its tasks with task_management.packs.items.add. Returns the pack.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_createNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.create".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

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

Update a task pack

task_management.packs.update

Changes one of the organization's task packs. Send the fields to change inside updates: name, description, color (hex like #3b82f6) or label_ids (pack labels; unknown ids are ignored); only what you send changes. Any other key inside updates is rejected (400 invalid_input). To edit the tasks of the pack use task_management.packs.items.update. Returns the pack.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_updateNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.update".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

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 PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a task pack

task_management.packs.delete

Deletes one of the organization's task packs with all its items. It goes to the 30-day trash and comes back whole (items included). Tasks already created from the pack are not touched. Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete.

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

task_management:write e «Permitir exclusões» (task_management:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

task_management_packs_deleteNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.delete".

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

Parâmetros

Resposta

Erros

Exemplo

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

Duplicate a task pack

task_management.packs.duplicate

Copies one of the organization's task packs with all its items into a new pack named '<name> (Copy)' (the suffix in the caller's language: '(Copia)', '(Copy)' or '(Cópia)'), owned by the caller. Returns pack_id and the new pack.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_duplicateNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.duplicate".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/duplicate" \
  -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 POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/duplicate" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Copy a library pack into the organization

task_management.packs.clone_system

Copies a published task pack of the MB Suite library (an id from task_management.packs.list with source system) into the organization, items included, so it can be edited. Drafts of the library cannot be copied. Returns pack_id and the new pack.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_clone_systemNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.clone_system".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/system/{system_pack_id}/clone" \
  -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 POST "https://api.mb-suite.com/v1/tasks/packs/system/{system_pack_id}/clone" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create the tasks of a pack

task_management.packs.apply

Creates one task per item of a pack (the organization's or a published library pack), due on anchor_date + the item's days_offset days, with the item's subtasks, priority and recurrence. target says where they go: the workspace (default), one of its Accounts (kind account + account_id) or private. Every task is assigned to default_assignee_id (default: the caller; null leaves them unassigned); items can override their assignee or due date, or be skipped (include: false). Subtasks are created unassigned, like in the app. Up to 200 items and 1,000 tasks with subtasks. Outside the app it requires a dry run (which lists the tasks and dates) and a confirm_token. Returns tasks_created (the top-level tasks, whose ids come in task_ids), subtasks_created and has_stale_end_date (a recurrence end date already past was dropped).

Pede confirmação: primeiro dry_run: true (prévia e confirm_token, válido por 10 minutos e por uma única execução), depois o mesmo corpo com confirm_token. Em algumas poucas, só com certos dados: a descrição diz quando. Por que e como: Prévia e confirmação.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_applyNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.apply".

Eventos que pode emitir

task_management.task.created

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/apply" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "anchor_date": 0,
  "dry_run": true
}'

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/tasks/packs/{pack_id}/apply" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "anchor_date": 0,
  "dry_run": true
}'

Add a task to a pack

task_management.packs.items.add

Adds an item to one of the organization's task packs: title, description, days_offset (days from the anchor date when the pack is applied), priority, subtasks (titles) and recurrence; at the end of the pack unless order is given. Returns the item.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_items_addNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.items.add".

Custo declarado: até 2 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/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "days_offset": 0
}'

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/tasks/packs/{pack_id}/items" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE",
  "days_offset": 0
}'

Edit a task of a pack

task_management.packs.items.update

Changes an item of one of the organization's task packs. Send the fields to change inside updates: title, description (the description of the task it creates, up to 5,000 characters; an empty text clears it), days_offset, priority_id (null clears it), subtasks (the whole list of titles), recurrence (null removes it) or order; only what you send changes. Any other key inside updates is rejected (400 invalid_input); a field sent next to updates instead of inside it is ignored, and without updates the call is 400 invalid_input. Returns the item with its fields.

Escopo

task_management:write

Permissão

Editar no módulo

Tool do MCP

task_management_packs_items_updateNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.items.update".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

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 PATCH "https://api.mb-suite.com/v1/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Remove a task from a pack

task_management.packs.items.delete

Removes an item from one of the organization's task packs (tasks already created from it are not touched). 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.

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

task_management:write e «Permitir exclusões» (task_management:delete no OAuth)

Permissão

Editar no módulo

Tool do MCP

task_management_packs_items_deleteNa superfície completa; na compacta, mb_execute_operation com id: "task_management.packs.items.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/tasks/packs/{pack_id}/items/{item_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/tasks/packs/{pack_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"