# PymtHouse

## Docs

- [PymtHouse Docs](https://docs.pymthouse.com/index.md): Add AI job signing, metered per-user billing, and OAuth authentication to your app in minutes.
- [Quickstart](https://docs.pymthouse.com/quickstart.md): Provision a user, mint a signed JWT, and verify usage tracking — all with working curl commands.
- [Integration patterns](https://docs.pymthouse.com/integration/integration-patterns.md): Three complete integration recipes — SaaS app with per-user billing, CLI with device login, and metered billing setup. Pick the one that matches your architecture.
- [Client model](https://docs.pymthouse.com/integration/client-model.md): The two-client pattern, OAuth scopes, API keys, and billing modes. Read this before writing any integration code.
- [API keys](https://docs.pymthouse.com/integration/api-keys.md): Long-lived opaque pmth_* API keys for app-level and per-user integrations. Exchange for short-lived JWTs or signer sessions.
- [Builder SDK](https://docs.pymthouse.com/integration/sdk.md): TypeScript client for the PymtHouse Builder API, Usage API, and OIDC issuer. Wraps M2M auth, user provisioning, token minting, signer integration, and billing in a single typed package.
- [Machine access](https://docs.pymthouse.com/integration/machine-access.md): Authenticate a backend service with PymtHouse using the OAuth 2.0 client credentials grant or HTTP Basic auth.
- [Interactive login](https://docs.pymthouse.com/integration/interactive-login.md): Authenticate end-users with PymtHouse using the OAuth 2.0 authorization code flow with PKCE.
- [Device flow](https://docs.pymthouse.com/integration/device-flow.md): Authenticate users from CLI tools, set-top boxes, and limited-input devices using RFC 8628 device authorization with optional third-party initiate login.
- [Token exchange](https://docs.pymthouse.com/integration/token-exchange.md): Use OAuth 2.0 Token Exchange (RFC 8693) to complete device authorization, obtain a remote signer session, or mint a user signer token via the clearinghouse.
- [User management](https://docs.pymthouse.com/integration/user-management.md): Create, upsert, update, and deactivate users in your PymtHouse app tenant via the Builder API. Manage per-user API keys, allowances, and subscription state.
- [User-scoped JWTs](https://docs.pymthouse.com/integration/user-tokens.md): Mint short-lived access tokens scoped to a specific end-user and capability via the Builder API.
- [Allowances](https://docs.pymthouse.com/integration/allowances.md): Manage per-user USD micro entitlement balances. Read allowance detail, grant manual top-ups, and check real-time access via the OpenMeter-backed allowances and balance APIs.
- [Billing summary](https://docs.pymthouse.com/integration/billing.md): Retrieve the current billing period, active plan, usage totals, daily timeline, overage calculations, and USD cost breakdown for your app.
- [Plans](https://docs.pymthouse.com/integration/plans.md): List, create, update, sync, and delete billing plans for your app. Plans define included allowances, overage rates, capability bundles, and OpenMeter sync state.
- [Usage API](https://docs.pymthouse.com/integration/usage-api.md): Query aggregated request counts, fee totals, and pipeline/model breakdowns for your app, powered by OpenMeter.
- [Signer routing](https://docs.pymthouse.com/integration/signer-routing.md): Integrate directly with the go-livepeer remote signer DMZ. Fetch routing config, proxy signing requests, and handle the identity webhook using @pymthouse/builder-sdk/signer/server and @livepeer/clearinghouse-identity-webhook.
- [App manifest](https://docs.pymthouse.com/integration/manifest.md): Read and update your app's network capability manifest — the set of pipeline/model combinations discoverable through PymtHouse. Supports ETag caching and SDK helpers.
- [Troubleshooting](https://docs.pymthouse.com/integration/troubleshooting.md): Common errors, diagnostic checklists, and fixes for PymtHouse integrations.
- [Deprecated routes and migrations](https://docs.pymthouse.com/integration/deprecated.md): Migration guide for removed endpoints. The hosted signer proxy, synchronous signed-ticket ingest, and legacy subscription and credits endpoints have been replaced.
- [API reference](https://docs.pymthouse.com/api-reference/introduction.md): Live OpenAPI specification, endpoint inventory, and how to authenticate against the PymtHouse HTTP APIs.

## OpenAPI Specs

- [openapi](https://docs.pymthouse.com/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/eliteprox/pymthouse)