---
title: "Pause or start a test"
method: PUT
path: "/api/v1/synthetics/tests/{public_id}/status"
tags: ["Synthetics"]
---

# Pause or start a test

`PUT /api/v1/synthetics/tests/{public_id}/status`

Pause or start a Synthetic test by changing the status.

## Path parameters

- `public_id` string, required

## Request body

- SyntheticsUpdateTestPauseStatusPayload — Object to start or pause an existing Synthetic test.
  - `new_status` 'live' | 'paused' — Define whether you want to start (`live`) or pause (`paused`) a Synthetic test.

## Response `200`

OK - Returns a boolean indicating if the update was successful.

- boolean

## Other responses

- `400` — JSON format is wrong.
- `403` — Forbidden
- `404` — - Synthetic Monitoring is not activated for the user - Test is not owned by the user
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)