Cargos

List management roles (cargos)

members.management_roles.list

Lists the organization's management roles in display order (name, color, order): the «cargos» (Sponsor, Paid Media Manager…) that label agency people on each Account they are assigned to and on the team cards, and that pre-fill when a member is assigned to an Account (members.members.set_management_role). They do not change access. The catalog that labels the agency team on an Account is the workspace's: read it there. Requires view access to Members.

Alcance

members:read

Permiso

Ver el módulo

Tool del MCP

members_management_roles_listEn la superficie completa; en la compacta, mb_execute_operation con id: "members.management_roles.list".

Costo declarado: hasta 501 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/members/management-roles" \
  -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/members/management-roles" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a management role (cargo)

members.management_roles.create

Creates a management role with a name (up to 80 characters) and an optional hex color (without it, the next color of the app's palette). It goes last in the order. Give it to members as their default with members.members.set_management_role, or per Account in members.members.update_assignments. Returns the role. Owner or admin only.

Alcance

members:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_management_roles_createEn la superficie completa; en la compacta, mb_execute_operation con id: "members.management_roles.create".

Costo declarado: hasta 1 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/members/management-roles" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

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

Update a management role (cargo)

members.management_roles.update

Updates a management role's name, color or position in the list, all inside updates: order is the position (0 = first; past the end = last) and the other roles shift to make room. Unknown fields are rejected. 404 management_role_not_found if it is not in this organization. Returns the role. Owner or admin only.

Alcance

members:write

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_management_roles_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "members.management_roles.update".

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

Parámetros

Respuesta

Errores

Ejemplo

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

Delete a management role (cargo)

members.management_roles.delete

Deletes a management role and clears it from every member that had it, as their default and in their assigned Accounts (the assignments themselves stay), in one write. The role stays 30 days in the trash, where an owner or admin can restore it (platform.trash.restore); restoring puts it back on those members, except where another role was set in the meantime. Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. 404 management_role_not_found. Owner or admin only.

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

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

Permiso

Editar en el módulo · Solo owner, admin

Tool del MCP

members_management_roles_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "members.management_roles.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/members/management-roles/{role_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/members/management-roles/{role_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"