---
# System prepended metadata

title: User Org/Group Permissions API

---

# User Org/Group Permissions API

### Format

All calls are returned in **JSON**.

### Status Codes

- **200** Successful GET and PUT.
- **201** Successful POST.
- **204** Successfull POST without response body.
- **401** Unauthenticated.
- **403** Forbidden.

### GET /users/<user_id>/permissions

#### Example Request
```shell
curl -X GET http://web-stage.voxy.com/users/5/permissions
```

#### Response
```json
{
    'organizations': [
        {
            'id': 1,
            'permissions': [
                'is_admin': true,
                'can_add_users': true,
                'can_modify_users': true,
                'can_view_users': true
            ]
        },
        {
            'id': 2,
            'permissions': [
                'is_admin': false,
                'can_add_users': false,
                'can_modify_users': false,
                'can_view_users': true
            ]
        }
    ],
    'groups': [
        {
            'id': 6,
            'permissions': [
                'is_admin': false,
                'can_add_users': false,
                'can_modify_users': true,
                'can_view_users': true
            ]
        }
    ]
}
```


### PUT /users/<user_id>/permissions

#### Example Request
```shell
curl -X GET http://web-stage.voxy.com/users/5/permissions \
-d "{'organizations': [{'id': 1, 'permissions': ['is_admin': false, 'can_add_users': true, 'can_modify_users': true, 'can_view_users': true]}]}"
```

#### Response
```
200 OK
```