---
title: "Trigger a current-state audit of one verifier against a repo"
method: POST
path: "/experimental/orgs/{orgId}/verifier-audits"
tags: ["Orgs", "Context"]
---

# Trigger a current-state audit of one verifier against a repo

`POST /experimental/orgs/{orgId}/verifier-audits`

Starts an audit that judges a single verifier against the current tree of the repo behind a context lineage, producing a pass/fail/na verdict per candidate file (or one verdict over the whole path list for a paths-scope verifier).

Responds 202 with the run’s ids when started. A verifier with no resolved scope binding for this repo is not rejected: the run is created and the workflow resolves the binding before auditing. Rejects a diff-scope verifier, a resolved scope with no include globs, and a repo the org cannot read, each with a distinguishable 400/404. Responds 409 when an audit for the same verifier, repo, and ref is already running, and 429 when the org already has the maximum number of audits in flight. Authored verifiers also require declarationId, which selects one live configured group and keeps groups over the same verifier definition independent.

## Path parameters

- `orgId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `lineageId` string, uuid, required
  - `verifierId` string, uuid, required
  - `declarationId` string, uuid

## Response `202`

Default Response

- object
  - `data` object, required
    - `runId` string, uuid, required
    - `workflowId` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Default Response
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2026-09-15** `050f3217cf2c` — 1 info
  - added the new optional request property `declarationId`
- **2026-09-04** `ffb03b5d287f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/verifier-audits/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/050f3217cf2c?raw)