API reference
Categories
A plain, unencrypted reference list managed by super users.
Categories are not part of the encrypted vault. Reading them is public;
writing needs a signed-in user with the super_user role.
| Method and path | Access | Purpose |
|---|---|---|
GET /api/v1/categories | public | List, with offset, limit, search and sorted |
GET /api/v1/categories/:id | public | One category |
POST /api/v1/categories | super user | Create |
PUT /api/v1/categories/:id | super user | Rename |
DELETE /api/v1/categories/:id | super user | Move to the trash |
PUT /api/v1/categories/:id/restore | super user | Bring back |
DELETE /api/v1/categories/:id/force | super user | Delete permanently |
Body
{ "name": "Work" }name is required and at most 100 characters.
List parameters
search: a case-insensitive match on the name, at most 100 characters.sorted: a column and a direction, such asname:asc. The columns arename,created_atandupdated_at; the default iscreated_at:desc.