Create a custom role

Create a custom role that you can assign to users, Teams, and API tokens.

Bearer authentication of the form Bearer <token>, where token is your auth token.

The ID of the Organization where you want to create the custom role.

The request body for creating the custom role.

The permissions included in the role.

The scope of the role.

The role's description.

The IDs of the Workspaces that the role is restricted to.

The time the role was created.

The role's permissions.

The IDs of Workspaces that the role is restricted to.

The time the role was last updated.

The role's description.

Internal Server Error

$	curl -X POST https://api.astronomer.io/v1/organizations/organizationId/roles \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Deployment_Viewer",
>	"permissions": [
>	"deployment.get"
>	],
>	"scopeType": "DEPLOYMENT"
>	}'

1	{
2	"createdAt": "2022-11-22T04:37:12Z",
3	"createdBy": {
4	"id": "clm8qv74h000008mlf08scq7k",
5	"apiTokenName": "my-token",
6	"avatarUrl": "https://avatar.url",
7	"fullName": "Jane Doe",
8	"subjectType": "USER",
9	"username": "user1@company.com"
10	},
11	"id": "cluc9tapx000901qn2xrgqdmn",
12	"name": "Deployment_Viewer",
13	"permissions": [
14	"deployment.get"
15	],
16	"restrictedWorkspaceIds": [
17	"cldbvzoi20182g8odxt8ehi5i"
18	],
19	"scopeType": "DEPLOYMENT",
20	"updatedAt": "2022-11-22T04:37:12Z",
21	"updatedBy": {
22	"id": "clm8qv74h000008mlf08scq7k",
23	"apiTokenName": "my-token",
24	"avatarUrl": "https://avatar.url",
25	"fullName": "Jane Doe",
26	"subjectType": "USER",
27	"username": "user1@company.com"
28	},
29	"description": "Subject can only view deployments."
30	}