Error Changing agent state from READY to NOT_READY via API

[Absaar Javed]

Hello'

I have been trying to change the agent state from READY to NOT_READY using following API:

URL : http://<host>/finesse/api/User/<AgentId>

Content Type: Application/XML

HTTP Request:   

<User>

<state>NOT_READY</state>

<reasonCodeId>25</reasonCodeId>

</User>

HTTP Method: PUT

Then I get the following error:

<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>

Now the problem here is that I have added this reason code into finesse via finesse Administrator Desktop.But I am still getting the same error suggesting that the reason code is not available.

Screen shot of finesse desktop is attached.

[dlender · Accepted solution]

You should be  using the reasoncode ID rather than the reasoncode itself

Get the reasoncode ID from  url:http://<FQDN>/finesse/api/User/<id>/ReasonCodes?category=NOT_READY

[Absaar Javed]

Thanx alot David, it works perfectly now.