Fly.io
Machines

Upsert Metadata Key

View as Markdown

Update metadata for a specific machine within an app by providing a metadata key.

POST
/apps/{app_name}/machines/{machine_id}/metadata/{key}

Update metadata for a specific machine within an app by providing a metadata key.

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

key*string

Metadata Key

Request Body

application/json

Upsert metadata key request

updated_at?string
value?string

Response Body

application/json

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