Create

Create a project role

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.

Show child attributes

permissions.action

enum<string>

required

Describe what action an entity can take. Possible actions: create, edit, delete, and read

Available options:

read,

create,

edit,

delete

permissions.subject

enum<string>

required

The entity this permission pertains to. Possible options: secrets, environments

Available options:

role,

member,

groups,

settings,

integrations,

webhooks,

service-tokens,

environments,

tags,

audit-logs,

ip-allowlist,

workspace,

secrets,

secret-rollback,

secret-approval,

secret-rotation,

identity,

certificate-authorities,

certificates

permissions.conditions

object

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

Show child attributes

permissions.conditions.environment

string

The environment slug this permission should allow.

permissions.conditions.secretPath

object

Show child attributes

permissions.conditions.secretPath.$glob

string

required

The secret path this permission should allow. Can be a glob pattern such as /folder-name/*/**

Minimum length: 1

slug

string

required

The slug of the role.

Minimum length: 1

description

string

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

object

Show child attributes

role.permissions.conditions.environment

string

role.permissions.conditions.secretPath

object

Show child attributes

role.permissions.conditions.secretPath.$glob

string

required

Minimum length: 1

role.permissions.subject

Minimum length: 1

role.projectId

string

required

role.slug

string

required

role.updatedAt

string

required

role.description

string | null