Update field
Update mutable attributes of an existing incident custom field.
Restrictions
Usage
- Only
display_name,description,options, anddefault_valuecan be changed;field_name,field_type, andvalue_typeare immutable. optionsanddefault_valuemust remain consistent with the field’s existing type — same rules as create.- 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
Field ID — 24-character hex ObjectID.
^[a-f0-9]{24}$New display name. Must remain unique within the account.
39New description.
Replacement options list. Must obey the same per-type rules as create.
Replacement default value. Type must match the field's existing field_type.
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.