Skip to main content
POST
Cancelar una compilación en curso

Permisos

Requiere un usuario de servicio o un token de acceso personal con el permiso ManageOrgSnapshots a nivel de organización.

Comportamiento

Cancela una compilación en curso (con estado pending o running) y devuelve la compilación con el estado cancelled. Solo se pueden cancelar las compilaciones en curso. Si la compilación ya está en un estado final (succeeded, failed o cancelled), la solicitud devuelve 409 Conflict y la compilación permanece sin cambios.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

build_id
string
requerido
org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Respuesta

Respuesta satisfactoria

Esquema público del recurso Build: vista opaca de "¿ya se completó correctamente?".

Según la especificación, no se expone ninguna introspección por plataforma/instantánea/job. Las futuras adiciones (triggered_by_repo, metadatos de compilación, etc.) son aditivas.

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