---
title: "Checkpoint Audit Chain"
method: POST
path: "/api/v1/teams/{team_id}/audit-log/checkpoint"
tags: ["audit-log"]
---

# Checkpoint Audit Chain

`POST /api/v1/teams/{team_id}/audit-log/checkpoint`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/teams/{team_id}/audit-log/checkpoint`
- Auth: none declared

Sign the current head. Returns the latest checkpoint if nothing changed.

## Path parameters

- `team_id` string, uuid, required

## Response `200`

Successful Response

- AuditCheckpointRead: A signed checkpoint receipt. Signed bytes: ``b"badge-audit-checkpoint-v1\0"`` followed by ``canonical_json({team_id, seq, head_hash, signed_at})`` (sorted keys, no spaces), Ed25519 under the key named by ``key_id``.
  - `seq` integer, required
  - `head_hash` string, required
  - `signed_at` string, required
  - `key_id` string, required
  - `signature` string, required
  - `format` string, required
  - `signature_status` 'valid' | 'invalid' | 'key_rotated', required
  - `signature_valid` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)