Skip to content

PATCH /measurements/{msm}/

Update an existing measurement.

PATCH /measurements/{msm}/ — fields

Comma-separated list of fields to include in response, in addition to 'type' and 'id' which are always present. Optional fields can be listed here also.

PATCH /measurements/{msm}/ — format[datetime]

Output datetimes in ISO-8601 format ('iso-8601' or 'json') or as seconds since the epoch ('unix' or 'timestamp')

PATCH /measurements/{msm}/ — msm

The unique measurement ID.

PATCH /measurements/{msm}/ — optional_fields

Comma-separated list of optional fields named to include in response objects.

PATCH /api/v2/measurements/{msm}/

Update an existing measurement.

Try it out

Playground

Authorization
Variables
Key
Value
Body
Authorizations

Authorizations

api-key
Type
API Key (header: Authorization)
or
session
Type
API Key (cookie: atlasess)
Parameters

Path Parameters

msm*

The unique measurement ID.

Type
integer
Required

Query Parameters

fields

Comma-separated list of fields to include in response, in addition to 'type' and 'id' which are always present. Optional fields can be listed here also.

Type
string
format[datetime]

Output datetimes in ISO-8601 format ('iso-8601' or 'json') or as seconds since the epoch ('unix' or 'timestamp')

Type
string
Valid values
"iso-8601""json""timestamp""unix"
optional_fields

Comma-separated list of optional fields named to include in response objects.

Type
string
Valid values
"participation_requests""participant_logs""current_probes""is_active""probe_sources""probes"
Request Body

Request Body

object

The fields that can be changed by the user after creation.

This is an interface that is used by both CoreMeasurementSerialiser and
MeasurementUpdateSerializer.

Indicates this measurement is publicly available. This may be changed from false to true, but not from true to false

Defaulttrue

User-defined description of the measurement

Automatic top-up measurements probes

Defaultfalse

The number of days after which disconnected probes should be replaced in a measurement

Maximum30
Minimum1
Default7

Minimum similarity level for replacement probes

Format"double"
Maximum1
Minimum0
Default0.5

The number of hours after which the DNS record of the target should be looked up again

Default0
Responses

Responses

application/json
object

The fields that can be changed by the user after creation.

This is an interface that is used by both CoreMeasurementSerialiser and
MeasurementUpdateSerializer.

Indicates this measurement is publicly available. This may be changed from false to true, but not from true to false

Defaulttrue

User-defined description of the measurement

Automatic top-up measurements probes

Defaultfalse

The number of days after which disconnected probes should be replaced in a measurement

Maximum30
Minimum1
Default7

Minimum similarity level for replacement probes

Format"double"
Maximum1
Minimum0
Default0.5

The number of hours after which the DNS record of the target should be looked up again

Default0
Samples