v1

latestOpenAPI 3.1.02026-07-265897154.5 KB

Audits & Issues

Trigger a site audit

Trigger a site audit (technical + AEO) for the project's pages and return the orchestrator job id; results land on GET /audits. Audits every tracked page by default, or the optional pageIds. Always audits the project's own verified domain. Action endpoint — enforces runnable-state, blocks pitch projects, and consumes the monthly audit quota. Requires the write scope. Supports Idempotency-Key replay.

post/api/mcp/projects/{projectId}/audits

Path parameters

projectIdstring uuid required

The project id.

Headers

Idempotency-Keystring

Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.

Request body

pageIdsstring[]

Pages to audit. Omit to audit every tracked page in the project.

Response

Audit started.

successboolean required

jobIdstring required

projectIdstring uuid required

pageCountinteger required

pageIdsstring[]

baseURLstring uri

messagestring