Overview
- Introduction
- Authentication
- Examples
Endpoints
- Identities
- Universal Auth
- Organizations
- Projects
- Project Users
- Project Identities
- Project Roles
- Environments
- Folders
- Secret Tags
- Secrets
- Secret Imports
- Identity Specific Privilege
- Integrations
- Service Tokens
- Audit Logs
- Certificate Authorities
- Certificates
Project Roles
Create
Create a project role
POST
/
api
/
v1
/
workspace
/
{projectSlug}
/
roles
Copy
Ask AI
curl --request POST \
--url https://app.infisical.com/api/v1/workspace/{projectSlug}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"slug": "<string>",
"name": "<string>",
"description": "<string>",
"permissions": [
{
"action": "read",
"subject": "role",
"conditions": {
"environment": "<string>",
"secretPath": {
"$glob": "<string>"
}
}
}
]
}'
Copy
Ask AI
{
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"slug": "<string>",
"permissions": [
{
"subject": "<string>",
"action": "<string>",
"conditions": {
"environment": "<string>",
"secretPath": {
"$glob": "<string>"
}
}
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"projectId": "<string>"
}
}
Authorizations
An access token in Infisical
Path Parameters
Slug of the project to create the role for.
Body
application/json
Response
200 - application/json
Default Response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
curl --request POST \
--url https://app.infisical.com/api/v1/workspace/{projectSlug}/roles \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"slug": "<string>",
"name": "<string>",
"description": "<string>",
"permissions": [
{
"action": "read",
"subject": "role",
"conditions": {
"environment": "<string>",
"secretPath": {
"$glob": "<string>"
}
}
}
]
}'
Copy
Ask AI
{
"role": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"slug": "<string>",
"permissions": [
{
"subject": "<string>",
"action": "<string>",
"conditions": {
"environment": "<string>",
"secretPath": {
"$glob": "<string>"
}
}
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"projectId": "<string>"
}
}
Assistant
Responses are generated using AI and may contain mistakes.