Skip to content
/
Delete pricing tier
Last updated
DELETE/v1/pricing-tiers/{tier_id}

Delete (soft delete) a pricing tier.

Admin only - Requires admin privileges. Default pricing tiers (tier_standard, tier_poc, tier_enterprise) cannot be deleted.

Path Parameters

tier_id string required

The unique identifier of the pricing tier to delete.

Returns

Returns a 204 No Content response on successful deletion.

cURL
curl -X DELETE https://api.aitronos.com/v1/pricing-tiers/tier_custom \
  -H "X-API-Key: $FREDDY_API_KEY"

Response

Returns 204 No Content on success.

Error Responses

404 Not Found

{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Pricing tier 'tier_custom' not found",
    "system_message": "Pricing tier 'tier_custom' not found",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}

409 Conflict

{
  "success": false,
  "error": {
    "code": "OPERATION_NOT_ALLOWED",
    "message": "Cannot delete default pricing tier 'tier_standard'",
    "system_message": "Cannot delete default pricing tier 'tier_standard'",
    "type": "client_error",
    "status": 409,
    "details": {
      "tier_id": "tier_standard"
    },
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}
Previous page
Next page