hosts

Publish versioned future offer (host owner)

Aggregate rate, included limits, available_from/available_until, optional maintenance window, expected_version. Versioned future offer only; never alters a running price.

post/api/v1/hosts/machines/{id}/offer

Request

Base URL: https://amplerun-api.spiry.org
URL: https://amplerun-api.spiry.org/api/v1/hosts/machines/{id}/offer
Auth: HTTP bearer

Path parameters

idstring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

Headers

Idempotency-Keystring uuid required

Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Request body

rate_micro_per_hourstring required

Unsigned base-10 integer as string; never a float.

available_fromstring date-time required

available_untilstring date-time required

expected_versionstring required

Unsigned base-10 integer as string; never a float.

Example request

{
  "rate_micro_per_hour": "1",
  "available_from": "2026-09-25T12:00:00Z",
  "available_until": "2026-09-25T12:00:00Z",
  "maintenance_windows": [
    {
      "starts_at": "2026-09-25T12:00:00Z",
      "ends_at": "2026-09-25T12:00:00Z"
    }
  ],
  "expected_version": "1"
}

Response

Offer version committed with new offer_version.

Changes

No recorded changes to this operation across all 1 revision of this API.