---
title: "Guides | Speedscale Docs"
description: "Explore practical how-to guides for using proxymock effectively in your API testing and traffic replay scenarios."
canonical: "https://docs.speedscale.com/proxymock/guides/"
---

[Documentation index](https://docs.speedscale.com/proxymock/llms.txt) | [Markdown](https://docs.speedscale.com/proxymock/guides/index.md) | [Canonical page](https://docs.speedscale.com/proxymock/guides/)

# Guides

This section contains how-to guides for practical uses of **proxymock**.

### 🔑 Fix Auth Errors on Replay

Expired bearer/OAuth tokens turn replays into a wall of 403s. Let proxymock detect the token handshake and generate a smart\_replace blueprint that re-uses the freshly minted token on every protected request.

[Fix Auth on Replay](https://docs.speedscale.com/proxymock/guides/recommendations)

### Replay Tuning

Measure HIT/MISS/PASSTHROUGH locally, inspect replay misses, and tune recordings or transforms until your mock set covers the traffic.

[Tune a Replay](https://docs.speedscale.com/proxymock/guides/replay-tuning)

### Mock Match Rate

Let an AI agent find why replayed requests miss their mocks and accept filter-scoped fixes until the match rate is 100%.

[Improve Match Rate](https://docs.speedscale.com/proxymock/guides/mock-match-rate)

### 🔐 Basic Auth Credentials Swap

Replace recorded HTTP Basic auth credentials with replay-target credentials in one click. Includes the full S3 push/pull workflow for staging recordings across machines.

[Swap Credentials](https://docs.speedscale.com/proxymock/guides/credentials-swap)

### LLM Simulation

Record and mock LLM API calls from OpenAI, Anthropic, Gemini, and other providers. Eliminate AI spend in development and CI.

[Mock LLM APIs](https://docs.speedscale.com/proxymock/guides/llm-simulation)

### Datadog Synthetics

Export recorded proxymock traffic into Datadog Synthetics tests with automatic auth redaction and step chaining.

[Open Guide](https://docs.speedscale.com/proxymock/guides/datadog-synthetics/)

### ⚡ gRPC Support

Learn how to use **proxymock** with gRPC services. Record, replay, and mock gRPC calls, and generate tests and mocks from a .proto file.

[Learn gRPC](https://docs.speedscale.com/proxymock/grpc/)

### 📋 OpenAPI Support

Learn how to use **proxymock** with OpenAPI specifications. Generate tests and mocks from your API schemas and validate responses.

[Learn OpenAPI](https://docs.speedscale.com/proxymock/guides/openapi)

### 🔧 Modify RRPairs

Learn how to modify and customize recorded request/response pairs. Transform data, update headers, and adapt traffic for different environments.

[Learn Modifications](https://docs.speedscale.com/proxymock/guides/modify-rrpairs)

<a id="configure-and-verify-replays"></a>

## Configure and verify replays

*   [Integration testing with Kiro](https://docs.speedscale.com/proxymock/guides/kiro/): review a testing spec and generate recorded-traffic tests with dependency mocks, assertions and native schema coverage.
    
*   [Replay a Speedscale Cloud Snapshot Locally](https://docs.speedscale.com/proxymock/guides/cloud-snapshot-local/): pull existing traffic, mock dependencies, and test the app on your laptop.
    
*   [Create and Verify Blueprints](https://docs.speedscale.com/proxymock/guides/blueprints/): save, preview, and check runtime transforms.
    
*   [Debug a Replay Step by Step](https://docs.speedscale.com/proxymock/guides/replay-debugger/): park before each request, run to the first failure, and inspect what was sent.
    
*   [Gate CI on Replay Results](https://docs.speedscale.com/proxymock/guides/replay-verdicts/): baseline comparisons, fix verification, and exit codes.
    
*   [Compare Response Meaning](https://docs.speedscale.com/proxymock/guides/semantic-comparison/): similarity thresholds and optional judging.