---
title: Platform roles
description: Platform roles define admin capabilities on this website. Built-in special roles such as super_admin and admin cannot be mutated like custom roles.
---

List platform roles.

```
GET /api/v1/{locale}/{websiteId}/platform-roles
```

Create a custom role (website superadmin).

```
POST /api/v1/{locale}/{websiteId}/platform-roles
```

```json
{
  "label": "string",
  "permissions": {
    "invite_platform_users": true,
    "remove_platform_users": false,
    "create_delete_routes": true,
    "update_pages_and_object_components": true,
    "update_header_footer": true,
    "create_update_delete_object_types": false,
    "manage_integration_secrets": false,
    "configure_integration_secret_policies": false,
    "define_integrations": true,
    "invoke_integrations": true,
    "object_types": {}
  }
}
```

Read, update, or delete a custom role.

```
GET|PUT|DELETE /api/v1/{locale}/{websiteId}/platform-roles/{roleId}
```

MCP: list/get/create/update/delete platform role tools. Inviting users and special-admin assignment are admin UI / manual MCP.