CustomFailureReason

Disable a custom failure reason

Disables a custom failure reason, hiding it from the failure reason picker. Requires Owner role. Cannot be used on default failure reasons.

post/customFailureReason/{custom_failure_reason_id}/disable

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/customFailureReason/{custom_failure_reason_id}/disable
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

custom_failure_reason_idstring required

The ID of the custom failure reason to disable

Response

The disabled custom failure reason

custom_failure_reason_idstring

Unique identifier for the custom failure reason

workspace_idstring

The workspace this failure reason belongs to. Null for default failure reasons.

display_namestring

The human-readable name displayed in the failure reason picker

descriptionstring

Optional short description of the failure reason

agent_guidelinesstring

Optional guidance prompt that helps result analysis decide when a failure should be assigned this reason.

is_defaultboolean

Whether this is one of the nine built-in default failure reasons

disabledboolean

Whether this failure reason is disabled. Disabled reasons are hidden from the picker but preserve historical assignments.

created_by_idstring

The user who created this failure reason

created_timeinteger

Creation timestamp in epoch milliseconds

last_updated_by_idstring

The user who last updated this failure reason

last_updated_timeinteger

Last update timestamp in epoch milliseconds

Changes

No recorded changes to this operation across all 37 revisions of this API.