Record a citation-audit verdict

POST

/api/resources/{id}/citation-audits

Maintainer:Not configured

OperationId:record_citation_audit

id is a routing address. The authorization subject is the finding that owns the block named in the request body, resolved server-side.

If that finding disagrees with id the write is refused with 404, so you cannot address one finding in the path while recording an audit against a block of another.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

text/plain

Citation audit recorded; returns the new kb_citation_audits.id

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/resources//citation-audits' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "block_id": "bd8cc6cb-1750-49ca-a3b6-034ebc9ab225",
    "reason": "string",
    "source": {
        "kind": "event",
        "value": "a860a344-d7b2-406e-828e-8d442f23f344"
    },
    "value": 0
}'

Response Example

400 - Example 1

{
    "error": {
        "code": "string",
        "details": {
            "cli_command": "string",
            "display_name": "string",
            "email": "string",
            "refusal": {
                "kind": "no_standing"
            },
            "request_url": "string"
        },
        "message": "string",
        "precondition": {
            "failed": [
                {
                    "current": null,
                    "expected": null,
                    "key": "string",
                    "tier": "open"
                }
            ]
        }
    }
}

Modified at 2026-10-18 18:41:22

Read one content block by address (the three-state resolution)

List a resource's relationships