Create

Create a project role

You can read more about the permissions field in the permissions documentation.

Authorizations

Authorization

string

header

required

An access token in Infisical

Path Parameters

projectSlug

string

required

Slug of the project to create the role for.

Body

application/json

name

string

required

The name of the role.

Minimum length: 1

permissions

object[]

required

The permissions assigned to the role.

• Option 1
• Option 2
• Option 3
• Option 4
• Option 5
• Option 6
• Option 7
• Option 8
• Option 9
• Option 10
• Option 11
• Option 12
• Option 13
• Option 14
• Option 15
• Option 16
• Option 17
• Option 18
• Option 19
• Option 20
• Option 21
• Option 22
• Option 23
• Option 24
• Option 25
• Option 26
• Option 27
• Option 28

Show child attributes

permissions.action

required

Describe what action an entity can take.

Available options:

read,

create,

edit,

delete

permissions.subject

enum<string>

required

The entity this permission pertains to.

Available options:

secrets

permissions.conditions

object

When specified, only matching conditions will be allowed to access given resource.

Show child attributes

permissions.conditions.environment

permissions.conditions.secretPath

permissions.inverted

boolean

Whether rule allows or forbids.

slug

string

required

The slug of the role.

Required string length: 1 - 64

description

string | null

The description for the role.

Response

200 - application/json

role

object

required

Show child attributes

role.createdAt

string

required

role.id

string

required

role.name

string

required

role.permissions

object[]

required

Show child attributes

role.permissions.action

required

Minimum length: 1

role.permissions.conditions

any

role.permissions.inverted

boolean

role.permissions.subject

Minimum length: 1

role.projectId

string

required

role.slug

string

required

role.updatedAt

string

required

role.description

string | null

role.version

number

default:

1