Skip to content

Attest

Operations

Method Endpoint Description
POST /attest Record Attestations across Spaces

Record Attestations across Spaces

POST /attest

Record an Attestation in each Space selected by WhereSpace, SpaceFilterID, ChangeOrderID and TargetStage, covering one Revision of each Unit WhereUnit selects there, named by Revision. When ChangeOrderID is given it defaults to the Revision a Release of the change would bundle, which the ChangeOrder's release Tag marks, or to the one its end Tag marks for a Unit the release Tag does not mark, so the approval satisfies its entry and release gates alike; it defaults to the head Revision otherwise. Each Space is recorded on its own and reported on its own.

Operation ID: Attest

Parameters

Query Parameters

Parameter Type Required Description
dry_run boolean Resolve the Revisions that would be covered and return the same response without writing anything.

Request Body

Content-Type: application/json

Schema: AttestRequest

Responses

Status Description Content-Type Schema
200 OK application/json AttestResult
207 Recording failed in some Spaces; each Space's result carries its own error application/json AttestResult
400 Attest request is invalid (Bad Request). application/json StandardErrorResponse
401 Unauthorized access. application/json StandardErrorResponse
403 Forbidden access. application/json StandardErrorResponse
404 Attest not found. application/json StandardErrorResponse
409 Attest data conflict. Data has changed since last read. application/json StandardErrorResponse
500 Something went wrong while processing Attest. application/json StandardErrorResponse
default Unexpected error. application/json StandardErrorResponse

Schemas

AttestRequest

Properties

Property Type Required Description
ChangeOrderID string (uuid)
Claims object
EvidenceAttestationIDs Array of UUID
ExpiresAt string (date-time)
Note string
Permissions Permissions
ReleaseID string (uuid)
Result string
Revision string
RevokedAttestationID string (uuid)
SpaceFilterID string (uuid)
TargetStage string
Type string
WhereSpace string
WhereUnit string

AttestResult

Properties

Property Type Required Description
Spaces Array of AttestSpaceResult

StandardErrorResponse

The body of an error response: the error as data (Error), and as one string (message) for clients written before Error.

Properties

Property Type Required Description
Error The error: its message, category (Type), HTTP status, details, and structured items.
message string The error as one string: its message, with any details, items, and individual errors appended. Kept for clients written before Error; new clients read Error.