Start a live agent audit

POST

/v1/audits/begin

curl --request POST \
  --url https://www.cemented.ai/v1/audits/begin \
  --header 'Content-Type: application/json' \
  --data '{ "text": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "title": "example", "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

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

text

required

string

>= 40 characters <= 20000 characters

id

required

string format: uuid

title

required

string

>= 1 characters <= 200 characters

project_id

string format: uuid

Example ^generated

{
  "text": "example",
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "title": "example",
  "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

200

Audit operation completed

Media type application/json

object

key

additional properties

Example ^generated

{
  "additionalProperty": "example"
}

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