Reroute Captured Router Request API

curl -X POST "https://router.example.com/v1/router/replay/req_9f3a2b/reroute" \
  -H "Authorization: Bearer <api-key>"

{
  "new_id": "req_7a4e1f",
  "decision": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "recipe": "semantic-router"
  },
  "response": {
    "id": "msg_01example",
    "choices": [
      {
        "index": 0,
        "message": {"role": "assistant", "content": "Hello again!"},
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 10,
      "completion_tokens": 8,
      "total_tokens": 18
    }
  }
}

curl -X POST "https://router.example.com/v1/router/replay/req_9f3a2b/reroute" \
  -H "Authorization: Bearer <api-key>"

{
  "new_id": "req_7a4e1f",
  "decision": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "recipe": "semantic-router"
  },
  "response": {
    "id": "msg_01example",
    "choices": [
      {
        "index": 0,
        "message": {"role": "assistant", "content": "Hello again!"},
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 10,
      "completion_tokens": 8,
      "total_tokens": 18
    }
  }
}

Use the Reroute endpoint to replay a previously captured request against the current router configuration. This is useful for regression testing: compare the new routing decision and provider response with the original to validate config changes. The request is re-executed against the live downstream provider unless you are in a restricted environment.

Endpoint

POST /v1/router/replay/{id}/reroute

Authentication

Authenticate with a session cookie or pass Authorization: Bearer <api-key>.

Path Parameters

string

required

Unique replay identifier from the list replay response.

Response

string

Identifier assigned to the new replayed request.

object

Routing decision produced by the current configuration.

Show properties

string

Selected provider name.

string

Resolved model name.

string

Matched recipe identifier.

object

Downstream provider response from the replayed request.

Show properties

string

Completion identifier.

array

Generated choices.

object

Token usage summary.

curl -X POST "https://router.example.com/v1/router/replay/req_9f3a2b/reroute" \
  -H "Authorization: Bearer <api-key>"

{
  "new_id": "req_7a4e1f",
  "decision": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "recipe": "semantic-router"
  },
  "response": {
    "id": "msg_01example",
    "choices": [
      {
        "index": 0,
        "message": {"role": "assistant", "content": "Hello again!"},
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 10,
      "completion_tokens": 8,
      "total_tokens": 18
    }
  }
}

PIN API

ROUTER API

AGENT API

Reroute Captured Router Request API

Endpoint

Authentication

Path Parameters

Response

​Endpoint

​Authentication

​Path Parameters

​Response

Endpoint

Authentication

Path Parameters

Response