intents

Generate (or return existing) a public review token and set whether the link includes evidence content. Existing tokens are preserved while their disclosure mode is updated.

token is a raw crypto.randomUUID() (v4 UUID, no prefix). Token and includeEvidence are persisted in one intent_specs UPDATE. A bodyless request is supported and resets the link to metadata-only. No 201 — created and pre-existing tokens both return 200. No rate limiter on this route.

post/api/v1/intents/{id}/share

Path parameters

idstring required

id path parameter.

Query parameters

workspace_idstring

Required only when authenticating via session cookie (ignored for API-key auth).

Request body

includeEvidenceboolean

Include linked evidence content and source in the public response. Defaults to false; metadata (id, type, severity) remains visible.

Response

Returns { token, includeEvidence } after atomically saving both settings

object required

Changes