Pause & resume

Pause and resume a monitor

Pausing a monitor stops all scheduled captures without deleting the monitor or its data. This is useful when you're doing maintenance on the target site or want to temporarily stop monitoring. When you resume, the next capture is scheduled immediately based on the monitor's frequency.

Pauses the monitor. Returns 409 if already paused.

Resumes a paused monitor and schedules the next capture. Returns 409 if the monitor is not paused.

bash

# Pause
curl -X POST https://api.snapshotarchive.com/v1/monitors/42/pause \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Accept: application/json"

# Resume
curl -X POST https://api.snapshotarchive.com/v1/monitors/42/resume \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Accept: application/json"

$client = new \GuzzleHttp\Client();
$headers = [
    'Authorization' => 'Bearer YOUR_API_KEY',
    'Accept' => 'application/json',
];

// Pause
$response = $client->post('https://api.snapshotarchive.com/v1/monitors/42/pause', [
    'headers' => $headers,
]);

// Resume
$response = $client->post('https://api.snapshotarchive.com/v1/monitors/42/resume', [
    'headers' => $headers,
]);

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

# Pause
requests.post(
    "https://api.snapshotarchive.com/v1/monitors/42/pause",
    headers=headers,
)

# Resume
requests.post(
    "https://api.snapshotarchive.com/v1/monitors/42/resume",
    headers=headers,
)

const headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
};

// Pause
await fetch("https://api.snapshotarchive.com/v1/monitors/42/pause", {
    method: "POST",
    headers,
});

// Resume
await fetch("https://api.snapshotarchive.com/v1/monitors/42/resume", {
    method: "POST",
    headers,
});

require "net/http"

# Pause
uri = URI("https://api.snapshotarchive.com/v1/monitors/42/pause")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"
http.request(request)

# Resume
uri = URI("https://api.snapshotarchive.com/v1/monitors/42/resume")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"
http.request(request)

client := &http.Client{}

// Pause
req, _ := http.NewRequest("POST", "https://api.snapshotarchive.com/v1/monitors/42/pause", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Accept", "application/json")
resp, _ := client.Do(req)
resp.Body.Close()

// Resume
req, _ = http.NewRequest("POST", "https://api.snapshotarchive.com/v1/monitors/42/resume", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Accept", "application/json")
resp, _ = client.Do(req)
resp.Body.Close()

Sync tags on a monitor

Replaces all tags on a monitor with the given set. Pass an array of tag IDs to assign, or an empty array to remove all tags. Only tags belonging to your account are accepted.

PUT/v1/monitors/{id}/tags

bash

curl -X PUT https://api.snapshotarchive.com/v1/monitors/42/tags \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"tag_ids": [1, 3, 5]}'

$client = new \GuzzleHttp\Client();
$response = $client->put('https://api.snapshotarchive.com/v1/monitors/42/tags', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'tag_ids' => [1, 3, 5],
    ],
]);
$data = json_decode($response->getBody(), true);

import requests

response = requests.put(
    "https://api.snapshotarchive.com/v1/monitors/42/tags",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={"tag_ids": [1, 3, 5]},
)
data = response.json()

const response = await fetch("https://api.snapshotarchive.com/v1/monitors/42/tags", {
    method: "PUT",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    body: JSON.stringify({ tag_ids: [1, 3, 5] }),
});
const data = await response.json();

require "net/http"
require "json"

uri = URI("https://api.snapshotarchive.com/v1/monitors/42/tags")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Put.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = { tag_ids: [1, 3, 5] }.to_json

response = http.request(request)
data = JSON.parse(response.body)

payload := `{"tag_ids": [1, 3, 5]}`
req, _ := http.NewRequest("PUT", "https://api.snapshotarchive.com/v1/monitors/42/tags", strings.NewReader(payload))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Accept", "application/json")
req.Header.Set("Content-Type", "application/json")

client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()