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. |