Finish or pause an audit

POST

/v1/audits/finish

curl --request POST \
  --url https://www.cemented.ai/v1/audits/finish \
  --header 'Content-Type: application/json' \
  --data '{ "audit_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "status": "complete" }'

Agent-driven live audit. Requires standard retention. The host agent selects material claims and submits verbatim quotes, which the standard Grounded snippet verifier matches against the report before researching and publishing structured findings through the Grounded compiler. Begin only saves the report; no hosted extraction or per-claim research is started.

Authorizations

• bearerAuth

Request Body ^required

Media type application/json

object

audit_id

required

string format: uuid

status

required

string

Allowed values: complete paused

Responses

200

Audit operation completed

Media type application/json

object

id

required

string format: uuid

text

required

string

<= 20000 characters

title

required

string

<= 200 characters

projectId

required

string | null format: uuid

claims

required

Array<object>

object

id

required

string

text

required

string

start

required

integer

end

required

integer

> 0

kind

required

string

Allowed values: factual calculation mixed

status

required

string

Allowed values: queued checking done error interrupted

requestId

string format: uuid

verdict

string

Allowed values: supported contradicted insufficient_evidence calculation_error

error

string

identified

required

boolean

identificationRequestId

string format: uuid

discoveryError

string

error

string

canRun

required

boolean

canPublish

boolean

isPublished

boolean

executionMode

string

Allowed values: browser agent

status

string

Allowed values: active complete paused stopped

Example

{
  "claims": [
    {
      "kind": "factual",
      "status": "queued",
      "verdict": "supported"
    }
  ],
  "canPublish": false,
  "isPublished": false,
  "executionMode": "browser",
  "status": "active"
}

201

Finding created

400

Invalid input or retention mode

401

Authentication required

404

Audit or claim unavailable

409

Conflicting report, attempt, or incomplete audit

422

Grounded finding validation failed