# Creating Measurements

Measurement creation is managed on the premise of needing to submit as little information as possible while still obtaining something useful. With that said, even the simplest measurement requires a rather large amount of information to initiate things. You will need to compose a measurement definition that has at least the type, af, description and target fields, as well as a probes object telling us which probes you want to use for the measurement.

If you omit the start_time, we assume you want it to start right away; if you don't set the is_oneoff flag, we assume it must be a regular measurement, and so on.

You will also have to use a valid key with the right permissions. See the section on keys for more information.

This section of the manual doesn't contain a try-it-out box, because it would create real measurements on the RIPE Atlas system and place unnecessary burden on the network. In addition, you would need a valid key.

If you do want to create measurements, you must use a tool that is able to send POST requests with a payload to RIPE Atlas. Three such tools are postman (a plug-in for Chrome), HttpRequester (a plugin for Firefox) and cURL (a command-line tool).

# Structure

Our measurement REST API uses a JSON payload with a POST verb to create new measurements.

You can fill in one or more measurement definitions, one or more probes objects, and some fields that are applicable to all measurements you want to create.

# The Response

The response to any successful POST request will return an object that has one field called measurements. This field holds an array that contains the IDs of the created measurements. The array reflects the order in which they were specified in the definitions list of your request.

Last Updated: Tuesday 21 May 2024