---
title: "PUT /roleAssignments/{roleAssignmentId}"
method: PUT
path: "/roleAssignments/{roleAssignmentId}"
tags: ["RoleAssignments"]
---

# PUT /roleAssignments/{roleAssignmentId}

`PUT /roleAssignments/{roleAssignmentId}`

Create role assignment.

## Path parameters

- `roleAssignmentId` string, required

## Query parameters

- `api-version` string, required

## Request body

- RoleAssignmentRequest — Role Assignment request details
  - `roleId` string, uuid, required — Role ID of the Synapse Built-In Role
  - `principalId` string, uuid, required — Object ID of the AAD principal or security-group
  - `scope` string, required — Scope at which the role assignment is created
  - `principalType` string — Type of the principal Id: User, Group or ServicePrincipal

## Response `200`

Success response.

- RoleAssignmentDetails — Role Assignment response details
  - `id` string — Role Assignment ID
  - `roleDefinitionId` string, uuid — Role ID of the Synapse Built-In Role
  - `principalId` string, uuid — Object ID of the AAD principal or security-group
  - `scope` string — Scope at the role assignment is created
  - `principalType` string — Type of the principal Id: User, Group or ServicePrincipal

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azuresynapse/apis/accesscontrolclient.md) · [All operations](https://skmtc.dev/azuresynapse/apis/accesscontrolclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azuresynapse/accesscontrolclient/revisions/3b2b8121ce98/schema)