hosts

Opt this machine in or out of renter-supplied public images (host owner)

Default false: a machine that never opted in never receives a custom image. Opting in is 409 while the marketplace has custom images disabled; opting out always works and wins any reservation in flight. Custom images still run under the mandatory launch profile. Each change is audited.

put/api/v1/hosts/machines/{id}/custom-images

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/hosts/machines/{id}/custom-images
  • 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

acceptboolean required

Response

Current opt-in.

machine_idstring uuid required
accepts_custom_imagesboolean required

Example response

{
  "machine_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40"
}

Changes

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