Delete field
Alert enrichment
Delete field
Delete an incident custom field and asynchronously strip it from existing incidents.
POST
Delete field
Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Incidents Manage (on-call) |
Usage
- The field is marked deleted synchronously; clearing its values from historical incidents runs in the background and may take time on large datasets.
- Re-creating a field with the same
field_nameis only allowed iffield_typeandvalue_typematch the deleted entry. - Audited — changes are recorded in the audit log.
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
application/json
Field ID — 24-character hex ObjectID.
Pattern:
^[a-f0-9]{24}$Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.