Fly.io
Machines

Update Metadata (set/remove multiple keys)

View as Markdown

Update multiple metadata keys at once. Null values and empty strings remove keys. + If `machine_version` is provided and no longer matches the current machine version, returns 412 Precondition Failed.

PUT
/apps/{app_name}/machines/{machine_id}/metadata

Update multiple metadata keys at once. Null values and empty strings remove keys.

  • If machine_version is provided and no longer matches the current machine version, returns 412 Precondition Failed.

Authorization

bearerAuth
AuthorizationBearer <token>

A Fly.io access token. Create one with fly tokens create.

In: header

Path Parameters

app_name*string

Fly App Name

machine_id*string

Machine ID

Request Body

application/json

Update metadata request

machine_version?string
metadata?
updated_at?string

Response Body

application/json

application/json

curl -X PUT "https://example.com/apps/string/machines/string/metadata" \  -H "Content-Type: application/json" \  -d '{}'
Empty
{  "details": {},  "error": "string",  "status": "unknown"}
{  "details": {},  "error": "string",  "status": "unknown"}

Get Metadata GET

Retrieve metadata for a specific Machine within an app.

Update Metadata (set/remove multiple keys) PUT

Update multiple metadata keys at once. Null values and empty strings remove keys. + If `machine_version` is provided and no longer matches the current machine version, returns 412 Precondition Failed.