Delete Staff Field (v1)
Method + Path
DELETE /v1/workspace/:workspaceId/staff/fields/:fieldId
Actual backend path: /v1/workspace/:workspaceId/staff/fields/:fieldId
Description
Permanently delete a custom field definition for staff members. This action cannot be undone.
caution
Deleting a field will remove it from all staff members. This action is irreversible.
Authentication
Required - JWT token in Authorization header
Required Permissions:
staff.update
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token: Bearer <token> |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspaceId | string | Yes | Workspace identifier |
fieldId | string | Yes | Field identifier |
Response (204)
No content - successful deletion.
Common Errors
- 401 Unauthorized: Missing or invalid authentication token
- 403 Forbidden: Insufficient permissions (requires
staff.update) - 404 Not Found: Field or workspace not found
- 500 Internal Server Error: Server error