Staff API
Auto-generated from the OpenAPI spec. Run
node docs-site/scripts/fetch-openapi.jsto regenerate.
GET /api/v1/permissions/catalog
Get Permission Catalog
Responses
- 200 — Successful Response
GET /api/v1/roles
List Roles
Responses
- 200 — Successful Response
POST /api/v1/roles
Create Role
Request body
| Field | Required | Type | Description |
|---|---|---|---|
name | Yes | string | |
permissions | No | array |
Responses
- 201 — Successful Response
- 422 — Validation Error
PUT /api/v1/roles/{role_id}
Update Role
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
role_id | path | Yes | integer |
Request body
| Field | Required | Type | Description |
|---|---|---|---|
name | Yes | string | |
permissions | No | array |
Responses
- 200 — Successful Response
- 422 — Validation Error
DELETE /api/v1/roles/{role_id}
Delete Role
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
role_id | path | Yes | integer |
Responses
- 204 — Successful Response
- 422 — Validation Error
GET /api/v1/staff
List Staff
Responses
- 200 — Successful Response
POST /api/v1/staff
Create Staff
Request body
| Field | Required | Type | Description |
|---|---|---|---|
full_name | Yes | string | |
email | Yes | string | |
password | Yes | string | |
role_id | Yes | integer |
Responses
- 201 — Successful Response
- 422 — Validation Error
PUT /api/v1/staff/{staff_id}
Update Staff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
staff_id | path | Yes | integer |
Request body
| Field | Required | Type | Description |
|---|---|---|---|
full_name | No | string | |
email | No | string | |
role_id | No | integer | |
new_password | No | string |
Responses
- 200 — Successful Response
- 422 — Validation Error
DELETE /api/v1/staff/{staff_id}
Delete Staff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
staff_id | path | Yes | integer |
Responses
- 204 — Successful Response
- 422 — Validation Error
POST /api/v1/staff/{staff_id}/deactivate
Deactivate Staff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
staff_id | path | Yes | integer |
Responses
- 200 — Successful Response
- 422 — Validation Error
POST /api/v1/staff/{staff_id}/reactivate
Reactivate Staff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
staff_id | path | Yes | integer |
Responses
- 200 — Successful Response
- 422 — Validation Error