Cancel a purchased DID and trigger a wallet refund. Tears down the SIP routing for the DID (inbound rule, trunk assignees, user outbound_caller_ids entry), cancels the DID order, and removes the local assignment row. The wallet refund itself lands when re

POST

https://api.veloconnect.me/api/did/assignments/{id}/cancel-and-refund

Telephony

Last modified:2026-06-01 19:28:25

Cancel DID + refund wallet.

Authentication: Requires JWT bearer token.

Path parameters: id (integer — required)

Success response (200): SuccessResponseModelOfDidAssignmentCancelResultDto

Request

Authorization

Path Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

cURLHttpiewget

curl --location --request POST 'https://api.veloconnect.me/api/did/assignments//cancel-and-refund'

Response Example

200 - Success Example

{
    "data": [
        {
            "succeeded": true,
            "refundAmount": 0,
            "refundCurrency": "string",
            "refundExpected": true,
            "didwwCanceled": true,
            "portSipTeardown": {
                "inboundRuleDeleted": null,
                "inboundTrunkAssigneeUpdated": null,
                "outboundTrunkAssigneeUpdated": null,
                "outboundCallerIdRemoved": null
            }
        }
    ]
}

Modified at 2026-06-01 19:28:25

Unassign a DID — removes the assignment row. Does not cancel the underlying purchase order.

Re-runs SIP provisioning for an existing assignment. Idempotent: safe to call repeatedly. Use to recover from drift when the DB says Provisioned but inbound calls don't land.