CorefinityCorefinityDocs
Open the Control PanelControl Panel
Team · 5 of 17

List the roles you may give

Answers the roles you may give somebody in your own company. data is a list with one item: an object whose keys are role slugs and whose values are role names. For each role's permissions, use GET /team/roles.

GET/api/roles

Returns

200 The roles you may give, slug to name.

Fields of the 200 answer
dataarray of objects or arraysRequired

One item, an object of role slug to role name. Empty when you may give no role. Up to 1 items.

messagestringRequired
statusstringRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/roles \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "data": [
    {
      "client-member-full": "Member (Full Access)",
      "client-member-limited": "Member (Limited Access)",
      "client-owner": "Owner",
      "release-managers-0b9c7a52-3f7e-4c1d-9a55-2f6f1f0e8d11": "Release managers"
    }
  ],
  "message": "all roles allowed loaded successfully",
  "status": "success"
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT