Skip to main content
POST
Generate a summary for a stack profile draft

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

draft_id
string<uuid>
required

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.