---
title: "Update user group access"
method: POST
path: "/userpermissions/{ct_user_id}"
tags: ["userpermissions"]
---

# Update user group access

`POST /userpermissions/{ct_user_id}`

Add/remove groups access for given ct_user_id

## Path parameters

- `ct_user_id` integer, required

## Request body

- UserPermissionsPost
  - `action` 'add' | 'remove' — Action to perform on organizational units. Type: enum (string); Allowed values: add, remove.
  - `org_units` object[] — org_units. Type: array of object.
    - `org_unit_id` integer — Organization unit (group) ID. Integer. Same concept as group_id; used in newer endpoints.
    - `org_unit_name` string — Name of the organizational unit. Type: string.

## Response `200`

Result of endpoint with specific messages respective to org_units given

- UserPermissionsPostResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` object[] — Response payload. Shape varies by endpoint.
    - `status` string — status of the respctive org_unit_id. Type: string.
    - `message` string — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).

## Other responses

- `default` — Unexpected error

---

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