v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1421129123.2 KB

Stops the canary to prevent all future runs. If the canary is currently running,the run that is in progress completes on its own, publishes metrics, and uploads artifacts, but it is not recorded in Synthetics as a completed run.

You can use StartCanary to start it running again with the canary’s current schedule at any point in the future.

post/canary/{name}/stop

Path parameters

namestring required

The name of the canary that you want to stop. To find the names of your canaries, use <a href="https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DescribeCanaries.html">ListCanaries</a>.

Response

Success

StopCanaryResponse required