---
title: "Charge the flat DSPy examples export fee (paid plans only, idempotent)"
method: POST
path: "/v1/billing/dspy-examples-charge"
---

# Charge the flat DSPy examples export fee (paid plans only, idempotent)

`POST /v1/billing/dspy-examples-charge`

## Request

- Base URL: `https://api.clichefactory.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clichefactory.com/v1/billing/dspy-examples-charge`
- Auth: none declared

Deduct the flat DSPy-examples export fee from a tenant's credit balance.

Idempotent on ``idempotency_key``: a retried call replays the original
charge (``charged=False``) instead of double-billing. Free-tier tenants are
rejected with 403 — purchasing the export bundle requires a paid plan, the
same gate as training. Insufficient balance returns 403 with a detail shape
matching the training rejection so existing Emio parsing applies.

## Headers

- `X-API-KEY` string, nullable

## Request body

- DspyExamplesChargeRequest
  - `tenant_id` string, required
  - `idempotency_key` string, required
  - `task_id` string, nullable

## Response `200`

Successful Response

- DspyExamplesChargeResponse
  - `charged` boolean, required
  - `credits` integer, required
  - `total_usd` number, required
  - `balance_credits` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clichefactory/apis/aio-server.md) · [All operations](https://skmtc.dev/clichefactory/apis/aio-server/llms.txt) · [OpenAPI document](https://skmtc.dev/clichefactory/apis/aio-server/revisions/9bd59f9bbb31?raw)