Help Center/ Cognitive Engagement Center/ API Reference/ Case2.0 Interface Reference/ Interface of a Single UPS/ Assigning a Case
Updated on 2025-03-31 GMT+08:00
View PDF
Share

Assigning a Case

Description

This interface is invoked to assign a case to an owner. For a case, only the current owner or a role with the owner assignment permission can transfer the case to change the case owner.

Method

POST

URI

https://Domain name/service/AICC__Case/1.0.0/openapi/case/transfer (For example, the domain name is service.besclouds.com.)

Request Description

Table 1 Request header parameters

No.

Parameter

Type

Mandatory or Not

Description

1

Content-Type

String

Yes

Request body type, which is JSON

2

access-token

String

Yes

Token for a user to access a tenant space. For details, see 2.
Table 2 Request body parameters

No.

Parameter

Type

Length (Bytes)

Mandatory or Not

Description

1

id

String

20

Yes

Case ID

2

ownerId

String

20

Yes

Case owner. In the automatic case assignment mode, this parameter can be left blank. The case creation interface will automatically assign the case to an owner based on the assignment logic.

3

creatorId

String

20

Yes

Handler ID

4

remark

String

2000

True

Description.

If the case type involved in the case assignment is associated with a customized case template, extended fields in the case template can be added to the request body.

Response Description

  • Status code: 200

None

Example

Scenario: Assign a case.

URL: https://Domain name/service/AICC__Case/1.0.0/openapi/case/transfer

  • Request header
{
 "Content-Type": "application/json",
 "access-token": "0000000000************7bm63KsRmEztTvyA="
}
  • Request body 
    {
    "id":"c6m800000142lp0xsJlI",
    "ownerId":"10gg0000012IpiXMqxzk",
    "creatorId": "10gg0000013wbIvo3zbk",
    "remark": "10330013wbIvo30bk"
}
  • Response header
{ "connection": "keep-alive",
 "Content-Length": "16",
"Content-Type": "application/json%3Bcharset=UTF-8"}
  • Response parameters
{"resCode": "0","resMsg": "Success"}