# Repost ## Docs - [Authentication and scopes](https://repost.sh/docs/agents/authentication.md): Authenticate agents with scoped tokens, cache identity once, and recover from missing-scope errors. - [Caching and performance](https://repost.sh/docs/agents/caching-performance.md): Cache stable facts, never cache moving ones, and back off deliberately when you must poll. - [Consistency model](https://repost.sh/docs/agents/consistency-model.md): The live observe stream versus the indexed store, the blind spot between them, and why stale reads cause conflicts. - [Diagnose a failing webhook](https://repost.sh/docs/agents/diagnose-webhooks.md): Find why a webhook failed with bounded searches, stable IDs, event detail, the delivery retry chain, and the DLQ. - [Discovery and self-description](https://repost.sh/docs/agents/discovery.md): Learn the command surface and output schemas directly from the binary, and install a repo-local agent primer. - [Guard a deployment](https://repost.sh/docs/agents/guard-deployments.md): Pause a forwarder before a deploy so webhooks queue instead of failing, then resume and confirm recovery with expect and health. - [Agents](https://repost.sh/docs/agents/index.md): Drive Repost from coding agents, CI jobs, and headless automation with stable JSON contracts, scoped tokens, and safe mutation rules. - [Output and errors](https://repost.sh/docs/agents/output-and-errors.md): The JSON envelope, the stdout/stderr split, exit codes, and the stable error codes the Repost CLI guarantees to programs. - [Provision buckets and forwarders](https://repost.sh/docs/agents/provision-targets.md): Create the route a webhook travels — a bucket that receives and a forwarder that delivers — idempotently, and verify the topology. - [Replay deliveries safely](https://repost.sh/docs/agents/replay-deliveries.md): Re-deliver events through a forwarder behind a mandatory dry-run, with idempotency, rate control, and exit-code-driven waiting. - [Safe mutations](https://repost.sh/docs/agents/safe-mutations.md): How agents change state safely: scope to one target, preview the blast radius, make it idempotent, gate bulk behind --yes, and wait on the result. - [Search and filters](https://repost.sh/docs/agents/search-and-filters.md): The query grammar for searching indexed history, the filter subset for live streams, and how cursor pagination behaves. - [Transcript safety](https://repost.sh/docs/agents/transcript-safety.md): What Repost redaction covers, what it provably does not, and the rules for keeping sensitive data out of agent transcripts. - [Wait for a webhook to arrive](https://repost.sh/docs/agents/wait-for-events.md): Block until a matching webhook arrives with expect, or capture a bounded live stream with tail, instead of polling search. - [Create a Repost Bucket for Webhook Ingestion Today](https://repost.sh/docs/buckets/create.md): Learn how to create a Repost bucket, choose between Queue and Proxy mode, and configure the response contract for your webhook providers. - [Repost Bucket Domains, Endpoint Labels, and URL Routing](https://repost.sh/docs/buckets/domains.md): Understand how Repost bucket domains work, how to change the endpoint label, and how the request path is preserved on incoming events. - [Bucket Response Behavior: Queue Mode vs Proxy Mode](https://repost.sh/docs/buckets/response-behavior.md): Learn how Queue and Proxy bucket modes respond to webhook senders, which delivery features each mode supports, and how to tune response fields. - [Configure Your Repost Bucket Settings After Creation](https://repost.sh/docs/buckets/settings.md): Edit bucket name, color, response behavior, active status, and deletion guardrails from the Repost dashboard bucket settings page. - [Authentication and configuration](https://repost.sh/docs/cli/authentication.md): Repost CLI authentication methods, credential storage, token lookup order, and configuration. - [Use the CLI in CI and automation](https://repost.sh/docs/cli/ci-automation.md): Authenticate without a browser, run headless forwarding, and pause or resume forwarders from a CI pipeline. - [Generate types](https://repost.sh/docs/cli/generate-types.md): Turn a real webhook payload into typed models from the forward TUI — pick a language, name the output, and tune inference and renderer options. - [Repost CLI](https://repost.sh/docs/cli/index.md): Use the Repost CLI to connect internal forwarders to your local machine, inspect webhook traffic, and manage forwarding from the terminal. - [Forward Live Webhooks to Your Local Machine with Repost](https://repost.sh/docs/cli/local-forwarding.md): Use repost forward to connect an internal forwarder to localhost, receive real webhook events in the CLI TUI, and inspect request and response details. - [Manage forwarders](https://repost.sh/docs/cli/manage-forwarders.md): List buckets and forwarders, check their status, and pause, resume, or disable delivery from the terminal. - [Quickstart](https://repost.sh/docs/cli/quickstart.md): Install the Repost CLI, sign in, and forward your first webhook event to localhost. - [Repost CLI Reference: Commands, Flags, and Shortcuts](https://repost.sh/docs/cli/reference.md): Complete reference for all repost CLI commands, flags, TUI keyboard shortcuts, and environment variables including auth, bucket, forwarder, and forward. - [repost schema fmt](https://repost.sh/docs/cli/schema/fmt.md): Format .repost files in place, or check formatting in CI with --check. - [repost schema generate](https://repost.sh/docs/cli/schema/generate.md): Generate every SDK declared in your schema, or verify with --check that the committed output hasn't drifted. - [repost schema import svix](https://repost.sh/docs/cli/schema/import.md): Convert a Svix environment export into a repost/ workspace, preserving the full version history. - [Define Webhook Schemas with the Repost CLI](https://repost.sh/docs/cli/schema/index.md): Use repost schema to scaffold, validate, format, version, and generate a type-safe TypeScript SDK and JSON Schema for your webhook events. - [repost schema init](https://repost.sh/docs/cli/schema/init.md): Scaffold a repost/ workspace: a starter schema, .env placeholders, and .gitignore entries. - [repost schema languages](https://repost.sh/docs/cli/schema/languages.md): List the supported SDK languages, with a JSON form describing each language's requirements and defaults. - [repost schema migrate deploy](https://repost.sh/docs/cli/schema/migrate-deploy.md): Apply committed migrations to a live environment, with ancestry checks, a confirmed --force path, and --dry-run. - [repost schema migrate dev](https://repost.sh/docs/cli/schema/migrate-dev.md): Record schema changes as a migration, confirm removals, reconcile forks, and regenerate every client. - [repost schema migrate status](https://repost.sh/docs/cli/schema/migrate-status.md): Report migration health without writing anything: the CI gate for forks, unmigrated changes, and tampered snapshots. - [repost schema push](https://repost.sh/docs/cli/schema/push.md): Send the current schema to a development environment without writing a migration. - [repost schema validate](https://repost.sh/docs/cli/schema/validate.md): Parse and validate the schema without writing anything. Errors fail; warnings don't. - [Configure Forwarder Routing, Timeouts, and Retry Rules](https://repost.sh/docs/forwarders/configuration.md): Adjust forwarder destination, path mode, timeout, retries, rate limits, and circuit breaker from the Repost dashboard settings page. - [Create a Forwarder and Connect It to Your Webhook Bucket](https://repost.sh/docs/forwarders/create.md): Create external or internal Repost forwarders, choose transparent or locked path routing, and configure delivery timeout and retry behavior. - [Transform Webhook Requests with Forwarder Functions](https://repost.sh/docs/forwarders/functions.md): Write TypeScript functions that transform webhook request path, headers, and body before a queued forwarder delivers the event to its destination. - [Store and Manage Encrypted Secrets for Your Forwarders](https://repost.sh/docs/forwarders/secrets.md): Create, rotate, and delete encrypted forwarder-scoped secrets that your TypeScript transform functions access through process.env at runtime. - [Manage Failed Webhook Deliveries in Repost Dead-Letter Queue](https://repost.sh/docs/history/failed-deliveries.md): Inspect, replay, and archive failed forwarder delivery attempts parked in the Repost dead-letter queue after all automatic retries are exhausted. - [Inspect Webhook Event History and Deliveries in Repost](https://repost.sh/docs/history/index.md): Use Repost event history to trace every webhook from provider to destination, inspect raw payloads, and identify delivery failures fast. - [Replay Webhook Events to a Forwarder Without Retriggering](https://repost.sh/docs/history/replay.md): Redeliver stored Repost events to a forwarder without retriggering the provider — replay one event, a selection, or a filtered history set. - [Search Repost Bucket and Forwarder History with Query Syntax](https://repost.sh/docs/history/search.md): Filter Repost bucket and forwarder history with field clauses, ranges, boolean operators, and JSON-path queries to find any webhook event. - [Repost Ingestion Documentation](https://repost.sh/docs/index.md): Learn the concepts behind Repost webhook ingestion: buckets, forwarders, and bucket modes. - [Core Concepts](https://repost.sh/docs/send/concepts.md): The six ideas behind Repost Send: environments, event types, customers, endpoints, messages, and deliveries. - [Configure the C# Client](https://repost.sh/docs/send/csharp/configuration.md): RepostClientOptions, credential and endpoint precedence, timeouts and retries with production defaults, and the injectable transport, clock, and generators. - [C# Code Generation](https://repost.sh/docs/send/csharp/generation.md): What the generated C# client contains, the generator block, build-time MSBuild generation, the CI drift check, and the descriptor version handshake. - [C# Quickstart](https://repost.sh/docs/send/csharp/quickstart.md): Install the CLI, add the Repost.Client package, generate a typed client from your schema, and publish your first event from .NET. - [Reliable Sends in C#](https://repost.sh/docs/send/csharp/reliability.md): Idempotency keys, the five delivery states, the RepostException taxonomy, what retries automatically, and bounded admission in the Repost C# client. - [Test C# Sends Without the Network](https://repost.sh/docs/send/csharp/testing.md): The Repost.Client.Testing package: the scripted StubTransport, recorded-request assertions, and deterministic clocks and generators. - [Branding and Theming](https://repost.sh/docs/send/customization.md): Put your name, colors, and logo on the customer portal and public event docs, configured per environment. - [Delivery, Retries, and Recovery](https://repost.sh/docs/send/delivery.md): What happens after a publish is accepted: the retry schedule, delivery statuses, the dead-letter queue, replay, and per-attempt logs. - [Migrations and Deploys](https://repost.sh/docs/send/deployments.md): Record schema changes as migrations, check them in CI, and deploy them to environments with safe rollback and fork detection. - [Customers and Endpoints](https://repost.sh/docs/send/endpoints.md): Manage who you send to: customers identified by your own ids, and endpoints with subscriptions, custom headers, pause and resume, and URL safety checks. - [Public Event Docs](https://repost.sh/docs/send/event-docs.md): A public documentation site for your event catalog, generated from your schema and rebuilt on every deploy. - [Go Compatibility and Security](https://repost.sh/docs/send/go/compatibility.md): Supported Go runtime, dependency, concurrency, transport, platform, verification, and security boundaries. - [Configure the Go Client](https://repost.sh/docs/send/go/configuration.md): Configure credentials, deadlines, retries, capacity, proxy, DNS, TLS, mTLS, HTTP/2, and connection pooling. - [Go Framework Integration](https://repost.sh/docs/send/go/frameworks.md): Own one generated client in a Go service, pass request contexts to sends, and close the client during graceful shutdown. - [Go Code Generation](https://repost.sh/docs/send/go/generation.md): Configure Go output, understand the generated package, regenerate safely, and keep generated descriptors compatible with the runtime. - [Observe the Go Client](https://repost.sh/docs/send/go/observability.md): Use runtime diagnostics, bounded lifecycle observers, and the optional OpenTelemetry metrics and tracing bridge. - [Go Quickstart](https://repost.sh/docs/send/go/quickstart.md): Generate a typed Go client from your schema and publish your first event with idempotency and explicit lifecycle ownership. - [Reliable Sends in Go](https://repost.sh/docs/send/go/reliability.md): Handle idempotency, delivery states, typed errors, cancellation, retries, deadlines, and bounded admission. - [Test Go Sends Without the Network](https://repost.sh/docs/send/go/testing.md): Use reposttest to script attempts, record redacted requests, control time, and assert lifecycle events with native Go tests. - [Repost Send](https://repost.sh/docs/send/index.md): A complete webhook sending system: define your events in a schema, publish with generated type-safe SDKs, and let Repost handle signed delivery, retries, and your customers' self-service. - [Java Compatibility and Security](https://repost.sh/docs/send/java/compatibility.md): The supported JDK, build-tool, and framework matrix for the Repost Java client, plus the dependency, redaction, native-image, and FIPS posture. - [Configure the Java Client](https://repost.sh/docs/send/java/configuration.md): Configure the Repost Java client: credential precedence, timeouts, retries, in-flight budgets, and proxy, TLS, and mTLS transport options. - [Java Framework Integration](https://repost.sh/docs/send/java/frameworks.md): Inject the Repost Java client with Spring Boot or Jakarta CDI, and wire the framework-neutral core into Quarkus, Micronaut, or Vert.x. - [Java Code Generation](https://repost.sh/docs/send/java/generation.md): How the Repost Maven plugin generates your Java client: the generator block, the repost:check CI gate, engine pinning, and multi-module aggregation. - [Observe the Java Client](https://repost.sh/docs/send/java/observability.md): Runtime diagnostics, lifecycle observers, and the Micrometer and OpenTelemetry bridges for the Repost Java client. - [Java Quickstart](https://repost.sh/docs/send/java/quickstart.md): Install the Repost Maven plugin and BOM, generate a type-safe Java client from your schema, and publish your first event with idempotency and stable delivery outcomes. - [Reliable Sends in Java](https://repost.sh/docs/send/java/reliability.md): Idempotency keys, the five delivery states, the exception taxonomy, async cancellation, and bounded admission in the Repost Java client. - [Test Java Sends Without the Network](https://repost.sh/docs/send/java/testing.md): Use StubTransport and the repost-client-test module to assert on sends, outcomes, and recorded requests with no network access. - [Kotlin Compatibility and Security](https://repost.sh/docs/send/kotlin/compatibility.md): The supported Kotlin, Gradle, JDK, and framework matrix for the Repost Kotlin client, plus the shared security baseline. - [Configure the Kotlin Client](https://repost.sh/docs/send/kotlin/configuration.md): Configure the Repost Kotlin client with the trailing-lambda DSL: credential precedence, timeouts, retries, and transport options. - [Kotlin Framework Integration](https://repost.sh/docs/send/kotlin/frameworks.md): Inject the Repost Kotlin client with Spring Boot or Jakarta CDI, drop the coroutine DSL into Ktor, and wire the framework-neutral core into Quarkus, Micronaut, or Vert.x. - [Kotlin Code Generation](https://repost.sh/docs/send/kotlin/generation.md): How the Repost Gradle plugin generates your Kotlin client: the generator block, the repostGenerateCheck CI gate, engine pinning, and multi-module aggregation. - [Observe the Kotlin Client](https://repost.sh/docs/send/kotlin/observability.md): Runtime diagnostics, lifecycle observers, and the Micrometer and OpenTelemetry bridges for the Repost Kotlin client. - [Kotlin Quickstart](https://repost.sh/docs/send/kotlin/quickstart.md): Apply the Repost Gradle plugin and BOM, generate a type-safe Kotlin client from your schema, and publish your first event with the coroutine DSL. - [Reliable Sends in Kotlin](https://repost.sh/docs/send/kotlin/reliability.md): Idempotency keys, the five delivery states, the exception taxonomy, coroutine cancellation, and bounded admission in the Repost Kotlin client. - [Test Kotlin Sends Without the Network](https://repost.sh/docs/send/kotlin/testing.md): Use StubTransport and the repost-client-test module to assert on sends, outcomes, and recorded requests with no network access. - [Polyglot Monorepos](https://repost.sh/docs/send/monorepos.md): One schema, many SDKs: generate clients for several languages and services from a single source of truth, with atomic writes and CI drift checks. - [The Customer Portal](https://repost.sh/docs/send/portal.md): A hosted self-service portal for your customers: endpoints, signing secrets, live delivery logs, the dead-letter queue, and your event catalog, reached through a link your backend mints. - [The HTTP API](https://repost.sh/docs/send/publishing.md): Publish events over plain HTTPS: one endpoint, an idempotency key, and clear status codes. - [Python Compatibility and Security](https://repost.sh/docs/send/python/compatibility.md): Supported Python runtimes, dependencies, concurrency, transport capabilities, native verification, and security posture. - [Configure the Python Client](https://repost.sh/docs/send/python/configuration.md): Configure credentials, deadlines, retries, capacity, proxy, DNS, TLS, and mTLS for the Python client. - [Python Framework Integration](https://repost.sh/docs/send/python/frameworks.md): Own one generated Repost client across Django, Flask, or FastAPI and close it during graceful shutdown. - [Python Code Generation](https://repost.sh/docs/send/python/generation.md): Configure Python output, understand the generated package, regenerate safely, and keep the runtime and descriptors compatible. - [Observe the Python Client](https://repost.sh/docs/send/python/observability.md): Runtime diagnostics, bounded lifecycle observers, OpenTelemetry metrics, and traces for the Python client. - [Python Quickstart](https://repost.sh/docs/send/python/quickstart.md): Generate a typed Python client from your schema and publish your first event with stable idempotency and delivery outcomes. - [Reliable Sends in Python](https://repost.sh/docs/send/python/reliability.md): Idempotency keys, delivery states, typed errors, retry rules, cancellation, and bounded admission in the Python client. - [Test Python Sends Without the Network](https://repost.sh/docs/send/python/testing.md): Use repost_client.testing to script attempts, record redacted requests, control time, and assert lifecycle events. - [Send Quickstart](https://repost.sh/docs/send/quickstart.md): Define an event, deploy it to an environment, publish it, and watch Repost deliver it, starting from an empty directory. - [Defining Events](https://repost.sh/docs/send/schema.md): Describe your events in a Prisma-style schema: payload models, event types, defaults, and wire names. The SDK, the payloads, and your event docs are generated from it. - [SDKs](https://repost.sh/docs/send/sdks.md): Generated, type-safe publishing clients for TypeScript, Go, Python, Java, and Kotlin, with retries, idempotency, and a no-network test mode built in. - [Signing and Verification](https://repost.sh/docs/send/signing.md): Every delivery is signed with Standard Webhooks: the headers, the HMAC scheme, secret rotation with an overlap window, and how your customers verify. - [Configure the TypeScript Client](https://repost.sh/docs/send/typescript/configuration.md): Client options, credential resolution, HTTP transport tuning, and the injectable clock and id generators. - [TypeScript Code Generation](https://repost.sh/docs/send/typescript/generation.md): How the generated package lands in node_modules, what it contains, custom output paths for monorepos, and the version handshake. - [TypeScript Quickstart](https://repost.sh/docs/send/typescript/quickstart.md): Install the runtime, generate a typed client into node_modules, and publish your first event from Node.js. - [Reliable Sends in TypeScript](https://repost.sh/docs/send/typescript/reliability.md): What the TypeScript client retries, how idempotency keys work, and every error a send can throw. - [Test TypeScript Sends Without the Network](https://repost.sh/docs/send/typescript/testing.md): The stub transport, custom transports for full-request assertions, and deterministic generators. - [Manage Repost Account Security, Passwords, and Sessions](https://repost.sh/docs/workspace/account-security.md): Update your password, review active sessions, and manage personal API tokens for your Repost account from the Account Settings security page. - [Repost Plans, Billing Intervals, and Event Quota Limits](https://repost.sh/docs/workspace/billing.md): Compare Repost Free, Starter, Pro, and Enterprise plans, switch subscriptions, manage billing details, and understand event quota and overage pricing. - [Repost Workspace: Settings and Organization Overview](https://repost.sh/docs/workspace/index.md): The Repost workspace is where you manage your team, API tokens, billing plan, and organization-wide traffic metrics from the dashboard. - [Manage Team Members, Roles, and Seat Licenses in Repost](https://repost.sh/docs/workspace/team.md): Invite teammates to your Repost workspace, assign Owner, Admin, or Member roles, and manage licensed seats for CLI and dashboard access. - [Create and Manage API Tokens for the Repost CLI and CI/CD](https://repost.sh/docs/workspace/tokens.md): Create personal or organization API tokens for CLI and automation access, set scopes and expiration, and revoke tokens that are no longer needed. - [Track Webhook Event Usage, Quota, and Overage in Repost](https://repost.sh/docs/workspace/usage.md): Track your workspace event consumption, quota limits, per-bucket traffic breakdown, and billing period overage from the Repost dashboard usage page. ## Optional - [Dashboard](https://app.repost.sh) - [Website](https://repost.sh)