Delete DID Reservation#

Deletes a DID Reservation.

Request#

HTTP Method: DELETE

URI Path: /v3/did_reservations/{id}

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID identifier of the DID Reservation.

Example#

http

1DELETE /v3/did_reservations/1156df17-bcea-4c9a-9c1d-29320e288c03 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/did_reservations/1156df17-bcea-4c9a-9c1d-29320e288c03 -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
2Content-Type: application/vnd.api+json

Other Responses#

Code

Success

Description

204

Yes

DID Reservation deleted.

404

No

Not Found

401

No

Unauthorized

403

No

Numbers selection is not enabled for the account. Also returned when the access token carries the read scope, which does not cover this method (title Insufficient scope, 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.