---
title: "POST /api/v1/audit/semantic"
method: POST
path: "/api/v1/audit/semantic"
tags: ["Audit"]
---

# POST /api/v1/audit/semantic

`POST /api/v1/audit/semantic`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- SemanticAuditEnvelope
  - `record` SemanticRecord, required
    - `action` string, nullable
    - `batchId` string, nullable
    - `breadcrumbId` string, nullable
    - `category` string, required
    - `contextId` string, nullable
    - `correlationId` string, nullable
    - `definition` string, nullable
    - `durationNanos` integer, nullable
    - `eventId` string, required
    - `evidence` string[], nullable
    - `exchangeId` string, nullable
    - `expert` string, nullable
    - `inputOmitted` string, nullable
    - `invocationId` string, nullable
    - `model` string, nullable
    - `namespace` string, nullable
    - `operation` string, nullable
    - `origin` string, nullable
    - `policyId` string, nullable
    - `policyVersion` string, nullable
    - `provider` string, nullable
    - `reasonCode` string, nullable
    - `requestId` string, nullable
    - `result` SemanticResult
      - `confidence` number, double, nullable
      - `probabilities` object, nullable
      - `probability` number, double, nullable
      - `value` unknown
    - `resultOmitted` string, nullable
    - `revision` string, nullable
    - `routeId` string, nullable
    - `rule` string, nullable
    - `schemaVersion` integer, required
    - `semantics` object, nullable
    - `startedAt` string, nullable
    - `status` string, nullable
    - `target` string, nullable
    - `timestamp` string, required
  - `source` SemanticSource, required
    - `catalog_digest` string, required
    - `catalog_revision` string, required
    - `forward_name` string, required
    - `instance_id` string, required
    - `namespace` string, required

## Response `200`

Accepted in memory; best effort persistence

- WanakuResponseSemanticAuditAcceptance
  - `data` object
    - `duplicate` boolean, required
    - `event_id` string, required
    - `status` string, required
  - `error` string, nullable

## Other responses

- `400`: Invalid semantic audit envelope
- `404`: Ingestion disabled
- `409`: Source event ID conflict
- `413`: Body exceeds 64 KiB
- `429`: External capacity unavailable
- `503`: Audit storage unavailable

## Changes

- **2026-10-13** `48c7f51551d2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wanaku-ai/apis/wanaku-api/changes/api/v1/audit/semantic/post.md)

---

[API](https://skmtc.dev/wanaku-ai/apis/wanaku-api.md) - [All operations](https://skmtc.dev/wanaku-ai/apis/wanaku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wanaku-ai/apis/wanaku-api/revisions/b09985e56872?raw)