DELETE /v1/projects/{id}/platforms/resources/{resourceId}
Gives one resource back, whatever it is. What that means is the resource’s own business: an SMS number goes back to the provider and is retired, a dedicated iMessage line goes back to the shared pool and stays in existence for someone else to claim. Either way the provider is contacted first where there is one, then a single transaction disables every ability, ends the project’s hold and closes the charge period — so a provider that refuses leaves the resource exactly as it was, still owned and still billed. Usually finishes inside this request and answers 200; if the provider is slow it answers 202 and the Location points at the operation to poll. The decrement runs behind the answer either way, so the resource is gone when you are told it is. Takes no Idempotency-Key — releasing the same resource twice is the same request. Releasing one that is already gone answers 404. Requires the platforms:write permission bound to the project resource in the path.
- TypeScript
- Python
- Rust
TypeScript
Parameters
string
required
string
required
Returns
200 The release finished inside this request. The resource is gone. Operation
Headers: Location. The raw response carries these headers; see Raw responses.
boolean
required
string (date-time)
required
object
string (date-time)
OperationError
string
required
string
required
OperationReason
string
string
required
string (date-time)
OperationState
required
OperationType
required
string (date-time)
required
202 The release is still running at the provider. GET the Location after the Retry-After interval; a terminal answer may arrive on any read. Operation
Headers: Location. The raw response carries these headers; see Raw responses.
boolean
required
string (date-time)
required
object
string (date-time)
OperationError
string
required
string
required
OperationReason
string
string
required
string (date-time)
OperationState
required
OperationType
required
string (date-time)
required