Delete a finished audit and its results

DELETE/api/v1/audits/{id}

Needs the audits:write scope. About scopes

Parameters

Name	In	Type	Description
`id` required	path	string (uuid)	Audit id

Responses

Status	Meaning	Body
204	No Content
400	The request isn't valid (invalid_request, invalid_body)	Error
401	No key, or the key is invalid, expired or revoked (key_required, key_invalid)	Error
403	The key lacks a scope, or the plan doesn't allow it (missing_scope, plan_no_api, plan_limit)	Error
404	Not found, or not yours (not_found)	Error
409	The site already has an audit running, or the audit has finished (audit_running, audit_finished)	Error
422	The site isn't verified and consent wasn't given (consent_required)	Error
429	Over the rate limit (rate_limited, rate_limited_daily)	Error

Examples

curl

curl -X DELETE "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b" \
  -H "Authorization: Bearer $KRITANO_API_KEY"

JavaScript

const res = await fetch("https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.KRITANO_API_KEY}`,
  },
});
const data = await res.json();

Python

import os
import requests

res = requests.delete(
    "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b",
    headers={"Authorization": f"Bearer {os.environ['KRITANO_API_KEY']}"},
)
res.raise_for_status()
data = res.json()

req, _ := http.NewRequest("DELETE", "https://app.kritano.com/api/v1/audits/0193f1b2-7c4e-7a1d-9b2a-3c5d6e7f8a9b", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KRITANO_API_KEY"))
res, err := http.DefaultClient.Do(req)