Project Roles
Update
Overview
- Introduction
- Authentication
- Examples
Endpoints
- Identities
- Token Auth
- Universal Auth
- GCP Auth
- AWS Auth
- Azure Auth
- Kubernetes Auth
- OIDC Auth
- JWT Auth
- Groups
- Organizations
- Projects
- Project Users
- Project Groups
- Project Identities
- Project Roles
- Project Templates
- Environments
- Folders
- Secret Tags
- Secrets
- Dynamic Secrets
- Secret Imports
- Secret Rotations
- Identity Specific Privilege
- App Connections
- Secret Syncs
- Integrations
- Service Tokens
- Audit Logs
Infisical PKI
- Certificate Authorities
- Certificates
- Certificate Templates
- Certificate Collections
- PKI Alerting
Infisical SSH
- Certificates
- Certificate Authorities
- Certificate Templates
Infisical KMS
- Keys
- Encryption
- Signing
Project Roles
Update
Update a project role
PATCH
/
api
/
v2
/
workspace
/
{projectId}
/
roles
/
{roleId}
curl --request PATCH \
--url https://us.infisical.com/api/v2/workspace/{projectId}/roles/{roleId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"slug": "<string>",
"name": "<string>",
"description": "<string>",
"permissions": [
{
"subject": "secrets",
"inverted": true,
"action": "read",
"conditions": {
"environment": "<string>",
"secretPath": "<string>",
"secretName": "<string>",
"secretTags": {
"$in": [
"<string>"
]
}
}
}
]
}'
{
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"slug": "<string>",
"permissions": [
{
"subject": "<string>",
"action": "<string>",
"conditions": "<any>",
"inverted": true
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"projectId": "<string>",
"version": 1
}
}
Authorizations
An access token in Infisical
Path Parameters
The ID of the project to update the role for.
The ID of the role to update
Body
application/json
The slug of the role.
Required string length:
1 - 64
The name of the role.
The description for the role.
The permissions assigned to the role.
The entity this permission pertains to.
Available options:
secrets
Describe what action an entity can take.
Available options:
read
, describeSecret
, readValue
, create
, edit
, delete
Whether rule allows or forbids.
Response
200
application/json
Default Response
Was this page helpful?
curl --request PATCH \
--url https://us.infisical.com/api/v2/workspace/{projectId}/roles/{roleId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"slug": "<string>",
"name": "<string>",
"description": "<string>",
"permissions": [
{
"subject": "secrets",
"inverted": true,
"action": "read",
"conditions": {
"environment": "<string>",
"secretPath": "<string>",
"secretName": "<string>",
"secretTags": {
"$in": [
"<string>"
]
}
}
}
]
}'
{
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"slug": "<string>",
"permissions": [
{
"subject": "<string>",
"action": "<string>",
"conditions": "<any>",
"inverted": true
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"projectId": "<string>",
"version": 1
}
}