Update a user's roles | Astronomer Docs

import requests
url = "https://api.astronomer.io/v1/organizations/organizationId/users/userId/roles"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "dagRoles": [
    {
      "dagId": "my_dag",
      "deploymentId": "clm8t5u4q000008jq4qoc3031",
      "role": "DAG_VIEWER"
    }
  ],
  "deploymentRoles": [
    {
      "deploymentId": "clm8t5u4q000008jq4qoc3031",
      "role": "DEPLOYMENT_ADMIN"
    }
  ],
  "organizationRole": "ORGANIZATION_OWNER,ORGANIZATION_OBSERVE_ADMIN,ORGANIZATION_OBSERVE_MEMBER,ORGANIZATION_BILLING_ADMIN,ORGANIZATION_MEMBER",
  "workspaceRoles": [
    {
      "role": "WORKSPACE_MEMBER",
      "workspaceId": "clm8t5u4q000008jq4qoc3036"
    }
  ]
}

Update Organization and Workspace roles for a user.

Authentication

AuthorizationBearer

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

Path parameters

organizationIdstringRequired

The ID of the Organization to which the user belongs.

userIdstringRequired

The user's ID

Request

The request body for updating the user's roles

dagRoleslist of objectsOptional

The user's updated DAG roles.

deploymentRoleslist of objectsOptional

The user’s updated Deployment roles. Requires also specifying an OrganizationRole.

organizationRolestringOptional

The user's updated Organization role.

workspaceRoleslist of objectsOptional

The user’s updated Workspace roles. Requires also specifying an OrganizationRole.

Response

The response body containing the user's roles

dagRoleslist of objects or null

A list of the subject's DAG roles.

deploymentRoleslist of objects or null

A list of the subject's Deployment roles. Currently only for API tokens.

organizationRolestring or null

The subject's Organization role.

workspaceRoleslist of objects or null

A list of the subject's Workspace roles.

Authentication

Path parameters

Request

Response

Errors