v1

latestOpenAPI 3.1.02026-07-26269227514.8 KB
snapshot_setup

Pin the org to a specific successful build

Pin a successful build (less than 7 days old).

Translates the SDK's 400 errors into 409 (per spec: "409 if the build is not succeeded, or older than 7 days").

post/v3beta1/organizations/{org_id}/snapshot-setup/builds/{build_id}/pin

Path parameters

build_idstring required
org_idstring required
Example:org-abc123def456

Organization ID (prefix: org-)

Request body

PinBuildBody required

POST /builds/{id}/pin body. Empty per spec.

Response

Successful Response

build_idstring required
completed_atinteger nullable required
created_atinteger required
pinnedboolean required
started_atinteger nullable required
status'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
trigger'manual' | 'auto' nullable required
triggered_by_user_idstring nullable required
updated_atinteger required