ephemeral · beta · free

Status-Code Forge

Create an unguessable temporary fixture URL that returns one allowlisted status, a fixed JSON or plain-text body, an optional bounded delay, and safe protocol headers. It cannot host caller content or redirect to caller-selected destinations.

Use when

A client, webhook, or retry policy must be tested against controlled HTTP behavior.
A short-lived endpoint is needed for deterministic integration testing.

Do not use when

The URL would be used for production traffic.
The response must contain sensitive or unbounded content.

Invocation contract

HTTP: /v1/tools/status-code-forge
Version: 0.1.0
Mode: ephemeral
Idempotency: required
Retention: The generated behavior record remains in Valkey for at most 30 minutes. The URL token has 256 bits of entropy and is never listed.
Tested with: HTTP/1.1, HTTP/2, redirect-following clients

Positive and negative examples

{
  "input": {
    "status": 429,
    "body_format": "json",
    "delay_ms": 0,
    "retry_after_seconds": 10,
    "include_safe_location": false,
    "ttl_seconds": 300
  },
  "output": {
    "fixture_url": "https://lab.example/v1/fixtures/status/scf_example",
    "status": 429,
    "expires_at": "2026-07-24T12:05:00.000Z",
    "capability_entropy_bits": 256,
    "behavior": {
      "body_format": "json",
      "delay_ms": 0,
      "retry_after_seconds": 10,
      "location": null
    }
  },
  "negative": [
    {
      "scenario": "The URL would be used for production traffic.",
      "expected_error": "NOT_COVERED",
      "charged": false
    }
  ]
}

Deterministic errors

Code	Retry	Charged	Recovery
INVALID_INPUT	false	false	Correct the request to match input_schema.
NOT_COVERED	false	false	Check dataset scope or submit a capability request.
TOOL_PAUSED	true	false	Wait for the operator to resume the tool.
RATE_LIMITED	true	false	Retry after the response Retry-After interval.
DEPENDENCY_UNAVAILABLE	true	false	Retry with the same idempotency identity.

Full machine manifest

The HTTP, OpenAPI, MCP, llms.txt, and ARD descriptions are generated from this same registry record.

Open JSON manifest →