Update DID Numbers

Request URL

PUT {base_url}/dm/open_api/v1/did_management

Request parameters

Headers


Parameter	Required	Type	Description
Authorization	Yes	String	Pass the access token in the header. Format: Bearer `{access_token}`.

Body parameters


Parameter	Required	Type	Description
didIds	Yes	Array<Intetger>	The ID list of DID numbers to be edited. Note: You can query the DID number ID using Query All the DID Numbers. Use a comma to separate multiple DID number IDs.
didName	No	String	The name of the DID number(s). Note: The length of the name should not exceed 127 characters.
trunkIds	Yes	Array<Integer>	The ID list of the trunk(s) to which the DID number(s) are assigned. Note: You can query the trunk ID using Query all the Shared Trunks interface. Use a comma to separate multiple trunk IDs.

Response parameters


Parameter	Type	Description
requestId	String	The unique ID of the request, which can be used to quickly locate the request.
status	String	Request result: `Success` `Failed`
time	Long	The response time. Note: The YCM API response returns a timestamp, you can convert the timestamp to detailed date and time as needed. For more information, see Convert Timestamp to Local Date and Time.

Example

Request example

Change the associated trunk of a DID number (ID: 50043).

PUT /dm/open_api/v1/did_management HTTP/1.1
Host: ycm.yeastar.com
Authorization: Bearer ******
Content-Type: application/json
{
    "didIds": [
       50043
    ],
    "trunkIds": [
        2,3
    ]
}

Response example

HTTP/1.1 200 OK
{
  "requestId": "44151421047434e0ef817a10fc5331a5",
  "status": "Success",
  "time": 1747027810
}