---
title: "Update user permissions"
method: PUT
path: "/api/v2/organizations/users/{user_id}/permissions"
tags: ["Orgs"]
---

# Update user permissions

`PUT /api/v2/organizations/users/{user_id}/permissions`

## Request

- Base URL: `https://api.kiloiot.io`
- URL: `https://api.kiloiot.io/api/v2/organizations/users/{user_id}/permissions`
- Auth: API key in header `X-API-Key` and API key in header `X-Organization-Id`

Update a user's role within the organization (admin, editor, viewer).

**Required scope:** `orgs:write`

## Path parameters

- `user_id` string, required

## Query parameters

- `organizationId` string, required

## Request body

- object
  - `permissions` object[]
    - `action` unknown
    - `object_text_code` string

## Response `200`

Successful response

## Other responses

- `401`: Missing or invalid API key
- `403`: Insufficient permissions (missing required scope)

---

[API](https://skmtc.dev/kiloiot/apis/kiloiot-public-api.md) · [All operations](https://skmtc.dev/kiloiot/apis/kiloiot-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kiloiot/apis/kiloiot-public-api/revisions/faf39bde186c?raw)