Sign in

v1

latestOpenAPI 3.1.02026-07-13250151.3 KB
evidence

Create a new evidence item under a product in the authenticated workspace.

Billing-gated: a 403 with body { error:'plan_limit_reached', metric:'evidence_items', current, limit, plan } is returned when the evidence_items quota is hit (distinct from the scope 403 which has body { error: 'Insufficient permissions...' }). Row stored with status='active', triage_status='inbox', created_by=auth.userId. Fires a Slack notify + PostHog evidence_created event (fire-and-forget). linkedIntentIds is [] on a fresh create.

post/api/v1/evidence

Query parameters

workspace_idstring

Required ONLY for cookie-session auth (no Bearer key); ignored for API-key auth.

Request body

contentstring required

Non-empty evidence text; trimmed before storage.

typestring required

One of friction | quote | observation | metric | request.

productIdstring required

Product must belong to the workspace (else 404).

sourcestring

Free-text source label; stored as null if omitted.

sourceUrlstring

Source URL; stored as null if omitted.

severitystring

low | medium | high | critical. 400 if invalid.

sentimentstring

positive | negative | neutral | mixed. 400 if invalid.

tagsstring[]

Tag array; defaults to [].

stagestring

Free-text journey stage; stored as null if omitted.

Response

Evidence created.

object required