---
seo:
  description: >-
    Public HTTP surface for the Charming app runtime. The narrative agent guide
    lives at https://charm.ing/docs/llms-full.txt; this spec is the
    machine-readable…
sidebar:
  label: Overview
title: Charming API
---
Public HTTP surface for the Charming app runtime. The narrative agent guide lives at https://charm.ing/docs/llms-full.txt; this spec is the machine-readable source of truth for routes, request/response shapes, and error kinds.

Timeout SLAs (`info["x-charming-sla"]` + per-operation `x-charming-timeout-ms`) are documentation only — they describe the targets the server tries to hit, not enforced ceilings. Use them to set sensible client read timeouts, not as hard guarantees.

<ApiOverview source="reference" />

## Operations

<ApiTagOperations source="reference" tag="operations" />

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.