---
title: "Compact Endpoint"
method: POST
path: "/v1/compact"
---

# Compact Endpoint

`POST /v1/compact`

## Request body

- CapsuleRequest
  - `lines` LineRecord[], required
    - `line_id` integer, required
    - `message` string, required
    - `level` string, nullable
    - `timestamp` string, nullable
    - `service` string, nullable
  - `metadata` object, nullable
  - `engine` 'auto' | 'inference' | 'deterministic', nullable

## Response `200`

Successful Response

- CompactResponse
  - `text` string, required
  - `stats` ParseStats, required
    - `llm_calls` integer, required
    - `cache_hits` integer, required
    - `unmatched` integer, required
    - `elapsed_ms` integer, required
    - `incident_family_hits` integer
    - `incident_induced_templates` integer
    - `global_cache_hits` integer
    - `global_shadow_hits` integer
    - `global_shadow_agreements` integer
    - `global_shadow_disagreements` integer
    - `total_patterns` integer
    - `candidate_patterns` integer
    - `dropped_patterns` integer
    - `cache_pattern_hits` integer
    - `global_cache_pattern_hits` integer
  - `compact_engine` string, nullable
  - `compact_fallback` string, nullable
  - `compact_error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/codag/apis/infra-logs-templater.md) · [All operations](https://skmtc.net/codag/apis/infra-logs-templater/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/codag/infra-logs-templater/revisions/e43028aaffe3/schema)