Skip to main content
POST
Generate a summary for a stack profile version (browser session)

Authorizations

ankra_session
string
cookie
required

Browser session. Mutations also require X-Ankra-CSRF.

Headers

X-Ankra-CSRF
string
required

Must match the CSRF cookie.

Path Parameters

profile_id
string<uuid>
required
version
integer
required
Required range: 1 <= x <= 2147483647

Body

application/json

Strict JSON, maximum 8192 bytes. Duplicate and unknown fields are rejected without echoing values.

expected_source_revision
integer
required
Required range: 1 <= x <= 2147483647
expected_summary_revision
integer
required
Required range: 0 <= x <= 2147483647
idempotency_key
string<uuid>
required

Canonical UUIDv7 issued within one hour; five minutes of future skew allowed. Reuse exactly for retries. Retained exact-key lookup precedes expiry. Never mint a replacement automatically for an expired key.

Pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-7[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$

Response

Accepted summary generation request

admission_enabled
boolean
required

Whether the service allows new generation requests. Current permission, consent and capacity are still checked at admission; retained exact-key replay remains available when false.

source_revision
integer
required
Required range: x >= 1
generation
object | null
required
summary
object
required

Current approval for this exact source revision, independent of retained generation history. A failed approval read is an error, never an absent summary.