Delete field
Alert enrichment
Delete field
Delete an incident custom field and asynchronously strip it from existing incidents.
POST
Delete field
Restrictions
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. - Deletion is rejected with
ReferenceExistand the referencing custom forms indata.refsuntil no form uses the field. - 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.