Global Fields

Several fields can be set at the root level of the creation request, outside the definitions array. When set globally, they propagate to all definitions that don't have them set explicitly.

start_time, stop_time, and is_oneoff

These can be set either globally or per-definition. Global values propagate to definitions that don't set them explicitly.

Important rules:

• These fields must have the same value across all definitions
• One-off measurements (is_oneoff: true) must not have stop_time set
• Conflicting values will cause the request to be rejected with an error

interval

Can be set individually per definition.

spread

Controls how measurement start times are distributed across probes within the interval. Behaves the same way as interval. See User-Defined Measurements for more details.

bill_to

By default, measurement costs are billed to your account. The bill_to field lets you charge another user's account instead. The other user must have added you to their allowed billing list.

See Credits for more information about the RIPE Atlas credit system.