CorefinityCorefinityDocs
Open the Control PanelControl Panel
Team · 11 of 13

corestack_team_role_create

Create a custom role.

Scope writeNo secrets returned
On this page

When to use it

Create a custom role for your company that gives a set of permissions. You may only give permissions the person you act for holds (corestack_team_permissions_list). Give it to people with corestack_team_member_role_attach. This is POST /api/roles/create.

Ask for it

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

Inputs

namestringRequired

Up to 255 characters.

permissionsarray of stringsRequired

Permission slugs from corestack_team_permissions_list.

scopeinteger

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

Example call

tools/call
{
  "name": "corestack_team_role_create",
  "arguments": {
    "name": "Release managers",
    "permissions": ["viewWebsites", "deployEnvironments"]
  }
}

If it is refused

ReasonWhat to do
forbiddenOnly an owner may create roles.
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