---
title: "Batch completion callback (internal)"
method: POST
path: "/api/v1alpha/batch_callback/{batch_id}"
tags: ["Builds"]
---

# Batch completion callback (internal)

`POST /api/v1alpha/batch_callback/{batch_id}`

## Request

- Base URL: `{{ base_url }}`
- URL: `{{ base_url }}/api/v1alpha/batch_callback/{batch_id}`
- Auth: none declared

Internal API, not for external use. The batch driver calls this when a batch owned by ci
completes, so CI can re-check it without waiting for its next poll. Only the batch service
and users with the manage_ci permission may call it. The request body is ignored.

## Path parameters

- `batch_id` integer, required

## Response `200`

Callback processed (non-ci batches are ignored)

## Other responses

- `401`: Unauthorized - requires the batch service or manage_ci permission
- `404`: Batch not found

## Changes

- **2026-11-12** `7e2de269f339`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hail-is/apis/hail-ci-service/changes/api/v1alpha/batch_callback/:batch_id/post.md)

---

[API](https://skmtc.dev/hail-is/apis/hail-ci-service.md) - [All operations](https://skmtc.dev/hail-is/apis/hail-ci-service/llms.txt) - [OpenAPI document](https://skmtc.dev/hail-is/apis/hail-ci-service/revisions/7e2de269f339?raw)