Roles

A role is a collection of permissions that can be assigned to a user group.

Data model

created_atstringDate and time in ISO 8601 format. Read-only.
custombooleanThis attribute is set to true if the role is managed by the customer. It is set to false if the role was created by Fastly.
descriptionstringDescription of the role.
idstringAlphanumeric string identifying the role.
namestringName of the role.
objectstringThe type of the object.
permissions_countintegerNumber of permissions assigned to the role.
updated_atstringDate and time in ISO 8601 format. Read-only.

Endpoints

List roles

GET/roles

Create a role

POST/roles

Get a role

GET/roles/role_id

Delete a role

DELETE/roles/role_id

Update a role

PATCH/roles/role_id

List permissions in a role

GET/roles/role_id/permissions

Add permissions to a role

POST/roles/role_id/permissions

Remove permissions from a role

DELETE/roles/role_id/permissions