RIPE Atlas Documentation

Managing Keys ​

Create a Key ​

shell
curl -X POST \
  -H "Authorization: Key YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "My New Key",
    "enabled": true,
    "grants": [{"permission": "create_measurement"}]
  }' \
  https://atlas.ripe.net/api/v2/keys/

Retrieve a Key ​

shell
curl -H "Authorization: Key YOUR-KEY" \
  https://atlas.ripe.net/api/v2/keys/{uuid}/

Update a Key ​

Use PATCH for partial updates or PUT for full replacement:

shell
curl -X PATCH \
  -H "Authorization: Key YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "Renamed Key"}' \
  https://atlas.ripe.net/api/v2/keys/{uuid}/

Delete a Key ​

shell
curl -X DELETE \
  -H "Authorization: Key YOUR-KEY" \
  https://atlas.ripe.net/api/v2/keys/{uuid}/

For the full list of key fields and their constraints, see the REST API Reference.