Skip to main content
POST
Épingler l’org sur un build réussi spécifique

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel doté de l’autorisation ManageOrgSnapshots au niveau de l’organisation.

Comportement

Épingle l’organisation à un build spécifique ayant réussi. Les nouvelles sessions utiliseront ce snapshot tant qu’il ne sera pas désépinglé.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

build_id
string
requis
org_id
string
requis

ID de l’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

application/json

Corps de POST /builds/{id}/pin. Vide conformément à la spécification.

Réponse

Réponse réussie

Schéma public de la ressource Build — vue opaque de type « est-ce que cela a réussi ? ».

Conformément à la spécification, aucune introspection de la plateforme, du snapshot ou des jobs n’est exposée. Les ajouts futurs (triggered_by_repo, métadonnées du build, etc.) sont additifs.

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