{"ok":true,"tool":"status-code-forge","module_version":"0.1.0","result":{"slug":"status-code-forge","name":"Status-Code Forge","version":"0.1.0","category":"ephemeral","status":"beta","mode":"ephemeral","summary":"Create a short-lived URL with controlled HTTP behavior.","description":"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.","when_to_use":["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."],"tested_with":["HTTP/1.1","HTTP/2","redirect-following clients"],"input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"anyOf":[{"type":"number","const":200},{"type":"number","const":201},{"type":"number","const":202},{"type":"number","const":204},{"type":"number","const":301},{"type":"number","const":302},{"type":"number","const":307},{"type":"number","const":308},{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":408},{"type":"number","const":409},{"type":"number","const":410},{"type":"number","const":422},{"type":"number","const":425},{"type":"number","const":429},{"type":"number","const":500}]},"body_format":{"default":"json","type":"string","enum":["json","text"]},"delay_ms":{"default":0,"type":"integer","minimum":0,"maximum":2000},"retry_after_seconds":{"type":"integer","minimum":1,"maximum":3600},"include_safe_location":{"default":false,"type":"boolean"},"ttl_seconds":{"type":"integer","minimum":60,"maximum":1800}},"required":["status","body_format","delay_ms","include_safe_location","ttl_seconds"],"additionalProperties":false},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fixture_url":{"type":"string","format":"uri"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"capability_entropy_bits":{"type":"number","const":256},"behavior":{"type":"object","properties":{"body_format":{"type":"string","enum":["json","text"]},"delay_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"retry_after_seconds":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"location":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["body_format","delay_ms","retry_after_seconds","location"],"additionalProperties":false}},"required":["fixture_url","status","expires_at","capability_entropy_bits","behavior"],"additionalProperties":false},"payment":{"kind":"free"},"side_effects":["Creates a temporary public HTTP fixture URL."],"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.","limits":{"min_ttl_seconds":60,"max_ttl_seconds":1800,"max_delay_ms":2000,"allowed_status_count":19,"excluded_ingress_rewritten_statuses":"502,503,504","caller_supplied_body_bytes":0,"max_client_requests_per_minute":10,"max_global_requests_per_minute":60},"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}]},"execution":{"errors":[{"code":"INVALID_INPUT","retryable":false,"charged":false,"recovery":"Correct the request to match input_schema."},{"code":"NOT_COVERED","retryable":false,"charged":false,"recovery":"Check dataset scope or submit a capability request."},{"code":"TOOL_PAUSED","retryable":true,"charged":false,"recovery":"Wait for the operator to resume the tool."},{"code":"RATE_LIMITED","retryable":true,"charged":false,"recovery":"Retry after the response Retry-After interval."},{"code":"DEPENDENCY_UNAVAILABLE","retryable":true,"charged":false,"recovery":"Retry with the same idempotency identity."}],"idempotency":{"required":true,"mock_or_unpaid_header":"Idempotency-Key","x402_extension":null,"replay_retention":"up to 24 hours"}},"endpoints":{"describe":"/v1/tools/status-code-forge","execute":"/v1/tools/status-code-forge"}},"meta":{"request_id":"req_df5a82ebcfcb4490a294df88c2b6db58","observed_at":"2026-07-24T23:23:57.546Z"}}