Skip to content
Aether Docs

Update the customer rate card

PUT
/api/v1/admin/rate-card
curl --request PUT \
  --url https://api.aetherplatform.cloud/api/v1/admin/rate-card \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "rates": [ { "resource_type": "control_plane", "unit_price_eur": 0 }, { "resource_type": "vcpu", "unit_price_eur": 6.5 } ] }'

Appends a new effective-now rate_cards row per submitted resource type and refreshes the in-process rate card so the change is live immediately. Each line is validated against the resource-type enum and the non-negative price constraint; a duplicated resource_type in one request is rejected. Requires the platform-admin realm role.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
rates
required
Array<object>
>= 1 items
object
resource_type
required
string
Allowed values: control_plane vcpu memory disk storage_block storage_rwx loadbalancer registry snapshot public_ip
unit_price_eur
required

€/month unit price (non-negative).

number format: double
Example
{
  "rates": [
    {
      "resource_type": "control_plane",
      "unit_price_eur": 0
    },
    {
      "resource_type": "vcpu",
      "unit_price_eur": 6.5
    }
  ]
}

Responses

Section titled “Responses”

200

Section titled “200”

The updated current effective rates.

Media typeapplication/json
object
rates
required
object
key
additional properties
number format: double
Examplegenerated
{
  "rates": {
    "additionalProperty": 1
  }
}

400

Section titled “400”

Invalid body — unknown resource_type, negative price, duplicate resource_type, or empty rates.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

403

Section titled “403”

The credential was accepted but lacks the required role or access (e.g. a non-platform-admin calling an /api/v1/admin endpoint).

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}