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
api-key
Type
API Key (header: Authorization)
or
session
Type
API Key (cookie: atlasess)
Parameters
Path Parameters
msm*
The unique measurement ID.
Type
Requiredinteger
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
The fields that can be changed by the user after creation.
This is an interface that is used by both CoreMeasurementSerialiser and
MeasurementUpdateSerializer.
Collapse
is_public
boolean
Indicates this measurement is publicly available. This may be changed from false to true, but not from true to false
Default
truedescription
string
User-defined description of the measurement
auto_topup
boolean
Automatic top-up measurements probes
Default
falseauto_topup_prb_days_off
integer
The number of days after which disconnected probes should be replaced in a measurement
Maximum
30Minimum
1Default
7auto_topup_prb_similarity
number
Minimum similarity level for replacement probes
Format
"double"Maximum
1Minimum
0Default
0.5target_update_hours
integer
The number of hours after which the DNS record of the target should be looked up again
Default
0Responses
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.
Collapse
is_public
boolean
Indicates this measurement is publicly available. This may be changed from false to true, but not from true to false
Default
truedescription
string
Required
User-defined description of the measurement
auto_topup
boolean
Automatic top-up measurements probes
Default
falseauto_topup_prb_days_off
integer
The number of days after which disconnected probes should be replaced in a measurement
Maximum
30Minimum
1Default
7auto_topup_prb_similarity
number
Minimum similarity level for replacement probes
Format
"double"Maximum
1Minimum
0Default
0.5target_update_hours
integer
The number of hours after which the DNS record of the target should be looked up again
Default
0