Tipos de proyecto

List project types

projects.types.list

Lists the organization's project types in their display order. A type configures the projects created from it: its statuses (each with a name and a category: open, in_progress, paused, done or cancelled; a project's status is one of them), its default phases, its custom field definitions (fields: name, slug, type, options) and its initial status. Archived types are left out unless include_archived is true. The list is empty if the organization never opened Projects: projects.projects.create without type_id creates the two built-in types. Requires view access to Projects.

Alcance

projects:read

Permiso

Ver el módulo

Tool del MCP

projects_types_listEn la superficie completa; en la compacta, mb_execute_operation con id: "projects.types.list".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Get one project type

projects.types.get

Returns one project type: name, description, color, icon, statuses (id, name, category, color), default phases, custom field definitions (fields: the slugs that the custom_fields of its projects use, with their type and options), initial status, whether it is the default type and whether it is archived. Not found if the id does not exist in this organization. Requires view access to Projects.

Alcance

projects:read

Permiso

Ver el módulo

Tool del MCP

projects_types_getEn la superficie completa; en la compacta, mb_execute_operation con id: "projects.types.get".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Create a project type

projects.types.create

Creates a project type: name, statuses (at least one, each with a name and a category: open, in_progress, paused, done or cancelled; ids are generated unless given), default phases, custom field definitions (fields; a slug comes from the name unless given), color, icon (an SVG path of a Material Design icon) and the initial status (default_status_id: the id of one of the given statuses; default the first). is_default makes it the type preselected for new projects and unmarks the previous one (the first type of an organization always is). Projects created later copy its statuses, phases and fields. Owners and admins only, as on the screen. Returns type_id and the type.

Alcance

projects:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

projects_types_createEn la superficie completa; en la compacta, mb_execute_operation con id: "projects.types.create".

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

Parámetros

Respuesta

Errores

Ejemplo

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

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

Update a project type

projects.types.update

Updates a project type: name, description (null clears), color, icon, statuses, phases, fields, initial status, is_default (only true: it becomes the default and the previous one stops being it) and is_archived (an archived type is not offered for new projects; its projects keep working). statuses, phases and fields replace the whole list: send every entry and keep the id of the ones that stay. Removing a status that projects use moves them to the type's initial status; changing a status between an open and a closed category updates their is_closed (up to 480 projects per call). A field keeps its slug. Projects already created keep their own item statuses and item fields. Owners and admins only. Returns the updated type.

Alcance

projects:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

projects_types_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "projects.types.update".

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

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/projects/types/{type_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/projects/types/{type_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a project type

projects.types.delete

Deletes a project type that no project uses; if some project still has it, it fails with project_type_in_use, which says how many and which (move those projects to another type or delete them first). To stop offering a type without deleting it, archive it. The dry run runs the same check (it fails the same way) and warns about the projects of this type that are in the trash: restored later, they come back with the organization's default type. The type goes to the 30-day trash and comes back as a non-default type when restored. Owners and admins only; outside the screen it requires a dry run and a confirm_token, except a REST DELETE with a key that can 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

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

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

projects_types_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "projects.types.delete".

Costo declarado: hasta 2 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/projects/types/{type_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/projects/types/{type_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"