SlashAgents-Version: 0.1
API: Example Payments API

Context:
- This API is optimized for low-volume, high-value payment operations.
- Prefer sequential write calls over burst concurrency.
- During bank cutoff windows, latency may increase.

Auth:
- OAuth2 Client Credentials
- Token endpoint: https://auth.example.com/oauth/token

Base URLs:
- Production: https://api.example.com
- Sandbox: https://sandbox-api.example.com

Versioning:
- Header: X-API-Version
- Default: 2026-01-01

Limits:
- Soft target: 20 req/s
- Burst: 40 req/s
- Recommended in-flight writes per account: <= 2

Retries:
- Retry 408/429/5xx with exponential jitter
- Respect Retry-After when present

Idempotency:
- Use Idempotency-Key on write operations
- Reuse same key when retrying after timeout

Pagination:
- Cursor-based with `cursor` and `limit`
- Max limit: 100

Errors:
- rate_limit: too many requests; wait and retry
- timeout: upstream timeout; retry with same idempotency key

Specs:
- OpenAPI: https://api.example.com/openapi.json
- Docs: https://api.example.com/docs

Runtime:
- Status: https://status.example.com/api/summary
- Recovery: replay timed-out writes with same idempotency key