Skip to main content
POST
Attivare una build manuale

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageOrgSnapshots a livello dell’organizzazione.

Comportamento

Avvia una build snapshot manuale per l’organizzazione. La build è asincrona — esegui il polling dell’endpoint di stato della build per monitorarne l’avanzamento.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json

Corpo di POST /builds. Vuoto secondo le specifiche; riservato a campi futuri.

Risposta

Risposta riuscita

Forma pubblica della risorsa Build — vista opaca del tipo "è già riuscita?".

Secondo la specifica, non è esposta alcuna introspezione a livello di piattaforma/snapshot/job. Le aggiunte future (triggered_by_repo, metadati della build, ecc.) sono additive.

build_id
string
obbligatorio
completed_at
integer | null
obbligatorio
created_at
integer
obbligatorio
pinned
boolean
obbligatorio
started_at
integer | null
obbligatorio
status
enum<string>
obbligatorio
Opzioni disponibili:
pending,
running,
succeeded,
failed,
cancelled
trigger
enum<string> | null
obbligatorio
Opzioni disponibili:
manual,
auto
triggered_by_user_id
string | null
obbligatorio
updated_at
integer
obbligatorio