Security & Users
Manage users, roles, permissions, and SSL certificates.
See also: Security & Users documentation | Full API Reference for interactive testing and complete schemas.
Endpoints
| Method | Path | Description | Reference |
|---|---|---|---|
| GET | /certificate-authority-service/certificates | List all certificates managed by the internal certificate authority | API Reference → |
| GET | /certificate-authority-service/details | Get details about the internal certificate authority | API Reference → |
| POST | /certificate-authority-service/issue | Issue a new certificate from the internal certificate authority | API Reference → |
| POST | /certificate-authority-service/renew | Renew a certificate via the internal certificate authority | API Reference → |
| POST | /certificate-authority-service/update | Update the internal certificate authority configuration | API Reference → |
| GET | /certificate-service/certificates | List all SSL/TLS certificates installed in Mango | API Reference → |
| POST | /certificate-service/csr | Generate a Certificate Signing Request (CSR) | API Reference → |
| POST | /certificate-service/install | Install an SSL/TLS certificate | API Reference → |
| POST | /certificate-service/renew | Renew the current SSL/TLS certificate | API Reference → |
| POST | /certificate-service/renewal-csr | Generate a CSR for certificate renewal | API Reference → |
| POST | /certificate-service/update | Update SSL/TLS certificate configuration | API Reference → |
| GET | /roles | Query Roles | API Reference → |
| POST | /roles | Create a Role | API Reference → |
| DELETE | /roles/{xid} | Delete a Role | API Reference → |
| GET | /roles/{xid} | Get a Role | API Reference → |
| PATCH | /roles/{xid} | Partially update a Role | API Reference → |
| PUT | /roles/{xid} | Update a Role List | API Reference → |
| GET | /system-permissions | Query permissions, their names and roles | API Reference → |
| GET | /system-permissions/{name} | Get a permission | API Reference → |
| PUT | /system-permissions/{name} | Update all of a Permission's Roles | API Reference → |
| GET | /users | Gets a list of users for bulk import via CSV | API Reference → |
| POST | /users | Create User | API Reference → |
| DELETE | /users/{username} | Delete a user | API Reference → |
| GET | /users/{username} | Get User by username | API Reference → |
| PATCH | /users/{username} | Partially update a User | API Reference → |
| PUT | /users/{username} | Update User | API Reference → |
| PUT | /users/{username}/homepage | Update a user's home url | API Reference → |
| PUT | /users/{username}/lock-password | Locks a user's password | API Reference → |
| PUT | /users/{username}/mute | Update a user's audio mute setting | API Reference → |
| POST | /users/approve-users | Approve publicly registered User(s) | API Reference → |
| GET | /users/bulk | Get a list of current bulk user operations | API Reference → |
| POST | /users/bulk | Bulk get/create/update/delete users | API Reference → |
| DELETE | /users/bulk/{id} | Remove a bulk user operation using its id | API Reference → |
| GET | /users/bulk/{id} | Get the status of a bulk user operation using its id | API Reference → |
| PUT | /users/bulk/{id} | Update a bulk user operation using its id | API Reference → |
| GET | /users/current | Get current user | API Reference → |
| GET | /users/export | Export formatted for Configuration Import by supplying an RQL query | API Reference → |
| GET | /users/export/{usernames} | Export user(s) formatted for Configuration Import | API Reference → |
| GET | /users/linked-accounts/{username} | Get OAuth/SSO linked accounts for a user | API Reference → |
| PUT | /users/linked-accounts/{username} | Update OAuth/SSO linked accounts for a user | API Reference → |
| POST | /users/query | Gets a list of users for bulk import via CSV | API Reference → |