List authorization permission groups | Astronomer Documentation

List the available permissions you can grant to a custom role.

Authentication

AuthorizationBearer

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

Query parameters

scopeTypeenumOptional

Filter the returned permissions based on the scope they apply to. Note that currently, the only available permissions are in the DEPLOYMENT and DAG scopes.

Allowed values:

Response

descriptionstring

The permission group's description.

namestring

The permission group's name.

permissionslist of objects

The permission group's permissions.

scopestring

The permission group's scope.

Errors

400

List Permission Groups Request Bad Request Error

401

List Permission Groups Request Unauthorized Error

403

List Permission Groups Request Forbidden Error

500

List Permission Groups Request Internal Server Error

1	[
2	{
3	"description": "Astro notification channel defines where alert messages can be sent. For example, alert messages issued via email or slack.",
4	"name": "workspace.notificationChannels",
5	"permissions": [
6	{
7	"action": "get",
8	"description": "Subject is permitted to get the scope."
9	}
10	],
11	"scope": "Workspace NotificationChannels"
12	}
13	]

$	curl -G https://api.astronomer.io/v1/authorization/permission-groups \
>	-H "Authorization: Bearer <token>" \
>	-d scopeType=DEPLOYMENT