Atlas
Admin — Roles

Create custom role

Creates a new custom role for the admin's active organization with the specified permissions.

POST
/api/v1/admin/roles

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3001/api/v1/admin/roles" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "permissions": [      "string"    ]  }'
{
  "role": {
    "id": "string",
    "orgId": "string",
    "name": "string",
    "description": "string",
    "permissions": [
      "string"
    ],
    "isBuiltin": true,
    "createdAt": "string",
    "updatedAt": "string"
  }
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "property1": null,
  "property2": null
}
{
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}
{
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "message": "string",
  "requestId": "string"
}