Itens

List the items of a project

projects.items.list

Lists the items of a project (its rows: a site, a campaign, a deliverable) in the order of the project's sheet, paginated by cursor. Each item comes with its status resolved against the project's item statuses (status: name and category; null when it has none) and the names of its people (person_names: uid → name). Archived items are left out unless include_archived is true; status_id ("" = without status) and assignee_id filter the page read, so a page can bring fewer than limit while has_more is true: follow next_cursor until has_more is false. Not found if the project is private to other people. Requires view access to Projects.

Escopo

projects:read

Permissão

Ver o módulo

Tool do MCP

projects_items_listNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.list".

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

Parâmetros

Resposta

Erros

Exemplo

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

Get one item of a project

projects.items.get

Returns one item of a project: title, status (resolved: name and category), assignees, dates, description, custom field values (keyed by the project's item field slugs) and the counters of its linked tasks. Not found if the item does not exist in that project, or if the project is private to other people (project_not_found). Requires view access to Projects.

Escopo

projects:read

Permissão

Ver o módulo

Tool do MCP

projects_items_getNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.get".

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

Parâmetros

Resposta

Erros

Exemplo

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

Add an item to a project

projects.items.create

Adds an item at the end of a project's sheet. Only title is required; status_id defaults to the project's initial item status ("" = without status). assignee_ids must be members of the organization. custom_fields are keyed by the project's item field slugs (projects.projects.get → item_fields) and validated by type: text, numbers, timestamps in milliseconds, { from, to } for date ranges, option values for selects, member uids for people fields; files cannot be set through the API. Updates the project's item count. Returns item_id and the item. Not found if the project is private to other people. Requires full access to Projects.

Escopo

projects:write

Permissão

Editar no módulo

Tool do MCP

projects_items_createNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.create".

Eventos que pode emitir

projects.item.created

Custo declarado: até 4 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/projects/{project_id}/items" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "TITLE"
}'

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

Update an item of a project

projects.items.update

Updates one or more fields of an item: title, status (one of the project's item statuses, or "" for none), assignees, dates (null clears), description, custom field values (merged: send only the slugs to change, null clears one) and is_archived (an archived item keeps its status and goes back to its column when unarchived). Returns the updated item. Not found if the item or its project does not exist, or the project is private to other people. Requires full access to Projects.

Escopo

projects:write

Permissão

Editar no módulo

Tool do MCP

projects_items_updateNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.update".

Eventos que pode emitir

projects.item.updated

Custo declarado: até 3 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/projects/{project_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/projects/{project_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete an item of a project

projects.items.delete

Deletes an item of a project: it stays 30 days in the trash, where an owner or admin can restore it to its project (platform.trash.restore); to hide one without deleting it, archive it with projects.items.update. Its linked tasks are not deleted: they keep their link and show the item again if it is restored. Updates the project's item count. Outside the screen it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. Not found if the item or its project does not exist, or the project is private to other people. Requires full access to Projects and a credential that allows deletion.

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

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

Permissão

Editar no módulo

Tool do MCP

projects_items_deleteNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.delete".

Custo declarado: até 5 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/projects/{project_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/projects/{project_id}/items/{item_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Set the order of a project's items

projects.items.reorder

Sets the manual order of a project's items (the order of its sheet and board): each id in item_ids (up to 500, no repeats) takes its position. Every id must be an item of that project, otherwise nothing is reordered (project_item_not_found). Items not listed keep their current position value, so send all of them for a clean order. It does not create, edit or delete items. Not found if the project is private to other people. Requires full access to Projects.

Escopo

projects:write

Permissão

Editar no módulo

Tool do MCP

projects_items_reorderNa superfície completa; na compacta, mb_execute_operation com id: "projects.items.reorder".

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

Parâmetros

Resposta

Erros

Exemplo

curl -X POST "https://api.mb-suite.com/v1/projects/{project_id}/items/reorder" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "item_ids": [
    "ITEM_ID"
  ]
}'

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/projects/{project_id}/items/reorder" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "item_ids": [
    "ITEM_ID"
  ]
}'