What does this error mean when using the Finesse API to change agent state to NOT_READY?

<ApiErrors>
  <ApiError>
    <ErrorType>Parameter Missing</ErrorType>
    <ErrorData>finesse.api.reasoncode.require_reasoncode</ErrorData>
    <ErrorMessage>The state change requires a valid reason code.</ErrorMessage>
  </ApiError>
</ApiErrors>


That error means that there are reason codes configured on the system, but the agent is trying to change the state to NOT_READY without a reason code. Per UCCE/UCCX spec, if reason codes are configured, one must be provided. In addition the Change Agent State with Reason Code REST API should be used, which essentially just has an additional tag of <ReasonCodeId>. To get the list of reason codes (and their ids) configured in the system, use the Get Reason Code List REST API.