---
title: "Set User Permissions"
method: PUT
path: "/users/{user_id}/permissions"
tags: ["Users"]
---

# Set User Permissions

`PUT /users/{user_id}/permissions`

Set the assigned permissions for a user.

## Path parameters

- `user_id` string, required

## Request body

- SetPermissionsRequest — Request body for setting user permissions.
  - `permissions` string[], required

## Response `200`

Successful Response

- UserResponse — User representation in API responses.
  - `active` boolean, required
  - `auth_provider` string, required
  - `created_at` string, date-time, required
  - `email` string, required
  - `external_subject_id` string, nullable
  - `first_name` string, required
  - `id` string, required
  - `invite_state` string, required
  - `last_name` string, required
  - `must_change_password` boolean, required
  - `name` string, required
  - `permissions` Permissions, required — Structured permissions view: assigned + effective.
    - `assigned` string[], required
    - `effective` EffectivePermission[], required
      - `implied_by` string, nullable
      - `name` string, required
  - `updated_at` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/versions/ff371f19960a/schema)
