Delete SMS Trunk Group#

Deletes an SMS trunk group together with all of its member trunks. The member trunks are not kept as standalone trunks. To keep a trunk, remove it from the group with Update SMS Trunk Group before deleting the group.

The request is rejected with 422 while any DID is routed to the group or to any of its trunks. Route those DIDs elsewhere, or clear their routing, through the DID resource first.

Request#

HTTP Method: DELETE

URI Path: /v3/sms_trunk_groups/{id}

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique identifier of the SMS trunk group.

Example#

http

1DELETE /v3/sms_trunk_groups/d2f4b6c8-3e5a-4b7d-9f1c-6a8e2d4b0c91 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X DELETE https://api.didww.com/v3/sms_trunk_groups/d2f4b6c8-3e5a-4b7d-9f1c-6a8e2d4b0c91 -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

1HTTP/1.1 204 No Content

Other Responses#

Code

Success

Description

404

No

Not Found

422

No

Validation Error Object. The group or one of its trunks is still assigned to DIDs.

401

No

Unauthorized

403

No

The access token carries the read scope, which does not cover this method (title Insufficient scope). The response carries WWW-Authenticate: Bearer error="insufficient_scope". See Scopes.

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.