---
title: "POST /internal/ci-builds/{build_id}/failure"
method: POST
path: "/internal/ci-builds/{build_id}/failure"
tags: ["CI runner"]
---

# POST /internal/ci-builds/{build_id}/failure

`POST /internal/ci-builds/{build_id}/failure`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/internal/ci-builds/{build_id}/failure`
- Auth: HTTP bearer

## Path parameters

- `build_id` string, required

## Request body

- RunnerFailure
  - `message` string, required

## Response `204`

Build failed and token revoked

## Other responses

- `401`: Token required
- `403`: Token rejected
- `409`: Build inactive

## Changes

> 81 revisions in range; 1 not diffed.

- **2026-10-17** `de8eaf663007`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gotempsh/apis/temps/changes/internal/ci-builds/:build_id/failure/post.md)

---

[API](https://skmtc.dev/gotempsh/apis/temps.md) · [All operations](https://skmtc.dev/gotempsh/apis/temps/llms.txt) · [OpenAPI document](https://skmtc.dev/gotempsh/apis/temps/revisions/ab6d5d19e930?raw)