add failure_status field and documentation