Update metadata

Create, update, or remove metadata values for specified key for given incident, monitor, or other resources.

POST https://uptime.betterstack.com/api/v3/metadata

Headers

Authorization
required string
Content_Type
string

Body parameters

owner_id
required string
owner_type
required string
key
required string
values
required array
201

Response body

{
  "data": {
    "id": "25",
    "type": "metadata",
    "attributes": {
      "key": "Key 1",
      "values": [{ "type": "String", "value": "Value 1" }, { "type": "String", "value": "Value 2" }]
      "owner_id": "2",
      "owner_type": "Monitor"
    }
  }
}
403

Example cURL

Example Typed values Remove metadata
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/metadata \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "key": "Key 1",
    "values": [
      { "value": "Value 1" },
      { "value": "Value 2" }
    ],
    "owner_id": "2",
    "owner_type": "Monitor"
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/metadata \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "key": "Key 1",
    "values": [
      { "type": "User", "item_id": "17" },
      { "type": "User", "email": "alice@betterstack.com" }
    ],
    "owner_id": "2",
    "owner_type": "Monitor"
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/metadata \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "key": "Key 1",
    "values": [],
    "owner_id": "2",
    "owner_type": "Monitor"
  }'