Scale supports idempotency for task creation endpoints. This allows you to resubmit requests that may have failed in transit without risk of creating duplicate tasks.

To use this feature, a unique_id attribute is expected to be provided into the task creation payload. The client is responsible for ensuring the uniqueness of your chosen keys. We recommend using V4 UUIDs.

If we later receive a matching request with the same idempotency key, no additional task will be created and the endpoint will return a 409 error.

Error CodesIntroduction