CorefinityCorefinityDocs
Open the Control PanelControl Panel
Team · 12 of 13

corestack_team_role_update

Edit a custom role.

Scope writeNo secrets returned
On this page

When to use it

Rename one of your company's custom roles and set the permissions it gives (the whole set; permissions the person you act for holds). Everybody holding the role gets the new set. This is POST /api/roles/{id}/update. A standard role, or another company's, answers tenant_mismatch.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_team_role_update with role_id 77, name Release managers, permissions ["viewWebsites"]. (Edit a custom role.) Tell me what it returned.

Inputs

namestringRequired

Up to 255 characters.

permissionsarray of stringsRequired

The whole set of permission slugs the role gives from now on.

role_idintegerRequired

The custom role's id from corestack_team_roles_list. At least 1.

scopeinteger

Always 4 (Custom); leave it out or send 4. It cannot be changed.

Example call

tools/call
{
  "name": "corestack_team_role_update",
  "arguments": {
    "role_id": 77,
    "name": "Release managers",
    "permissions": ["viewWebsites"]
  }
}

If it is refused

ReasonWhat to do
forbiddenYou may not edit roles (an owner, or the Edit Roles permission, may).
invalid_argumentsOn permissions: "… is not a permission." for a name that is not one ("… is not a permission (it was removed)." for a retired one, such as assignRoles), or "You are not allowed to add … permission." for one you do not hold, or "… is a Corefinity staff permission: a company's custom role cannot hold it." for a staff permission, even one you hold; or on name.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT