DELETE
/rates/{rate_gid}Delete a rate
Deletes a rate identified by its global identifier. Use this operation when you no longer need the rate; the successful response contains an empty object.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
200Returns an empty object after the rate is successfully deleted.
dataobjectoptional
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
400Returned when the request is missing required information or contains malformed input.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
402Returned when deleting the rate exceeds the current premium level.
errorsarray<object>optional
403Returned when the authenticated user does not have access to delete the rate.
errorsarray<object>optional
404Returned when the requested action is unknown or no rate exists for the specified `rate_gid`.
errorsarray<object>optional
500Returned when a server-side problem prevents the rate from being deleted.
errorsarray<object>optional
Error handling
A 400 is returned when the request is malformed. A 401 indicates that no valid authentication token was provided, while a 403 indicates that the authenticated user cannot delete the rate. A 404 means the rate identified by rate_gid does not exist; 402 indicates that the operation exceeds the current premium level, and 500 indicates a server-side failure.