API Reference
Connection and Authentication
Section titled “Connection and Authentication”- Base URL:
https://<your-tier0-host>/openapi/v2 - Authentication: Send your Tier0 API key in the
x-api-keyrequest header.
Checking Results
Section titled “Checking Results”- For
/uns/requests, check both the HTTP status and the response body. A successful response has a2xxstatus andcode: 0. Read the result fromdata. - On failure, inspect
error.codefor the reason and keeprequestIdfor troubleshooting. - For batch requests, check each item even when the HTTP status is
200. Some items may have failed.
Retrying Writes
Section titled “Retrying Writes”- Check
error.executionto see whether the write was started, rolled back, committed, or has an unknown outcome. - If
error.retry.safeistrue, retry the same request with the same idempotency key. If one was supplied, wait at least as long as indicated byerror.retry.afterMsor theRetry-Afterheader. - If part of a batch was committed, check which items succeeded before submitting any remaining work. If the outcome is unknown and the response does not confirm a safe retry, verify whether the write took effect before sending it again.