Begin or revise claim research

POST

/v1/audits/begin-claim

curl --request POST \
  --url https://www.cemented.ai/v1/audits/begin-claim \
  --header 'Content-Type: application/json' \
  --data '{ "audit_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "claim_id": "example", "previous_request_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

audit_id

required

string format: uuid

claim_id

required

string

/^p\d+$/

previous_request_id

string format: uuid

Example ^generated

{
  "audit_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "claim_id": "example",
  "previous_request_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