v1

latestOpenAPI 3.1.02026-07-13250151.3 KB
intents

Generate (or return existing) a share token for the intent, used to build public review links. Idempotent: returns the existing token if one is already set.

token is a raw crypto.randomUUID() (v4 UUID, no prefix), generated by reviewService.generateShareToken and persisted to intent_specs.share_token. 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).

Response

Returns { token } (existing or newly generated)

object required