Help Center/ Cognitive Engagement Center/ API Reference/ Call Center Configuration Interface Reference/ Agent Management/ Unbinding an Agent from a Skill Queue (releaseAgentBySkillId)
Updated on 2023-09-27 GMT+08:00
View PDF

Unbinding an Agent from a Skill Queue (releaseAgentBySkillId)

Scenario

Unbind an agent from a skill queue based on the skill queue ID and agent account.

Method

POST

URI

https://Domain name/apiaccess/rest/cc-management/v1/agentAccount/releaseAgentBySkillId. For example, the domain name is service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

x-app-key

String

No

App key field, which is the user ID. Contact the operation personnel to obtain the app key.

2

Authorization

String

Yes

Authentication field. The format is Bearer {Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)
Table 2 Request body parameters

No.

Parameter

Type

Mandatory or Not

Description

1.1

skillId

Integer

Yes

Skill queue ID.

1.2

userAccounts

Array

Yes

Agent account array. The value is a character string. An empty array can be transferred, indicating that all agents bound to the skill queue are unbound from the skill queue.

Response Description

  • Status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Type

    Mandatory or Not

    Description

    1.1

    resultCode

    String

    Yes

    If the request is successful, 0 is returned. If the request fails, 1 is returned.

    1.2

    resultMessage

    String

    Yes

    Carried failure cause if the request fails.
  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

Scenario description: Unbind agents from skill queue 3.

Request parameters:

{
  "skillId":3,
	"userAccounts":[]
}

Response parameters:

{
  "resultCode": "0",
  "resultMessage": "success"
}
Parent topic: Agent Management