Skip to main content

Server Endpoints

Reference for briefcase-server HTTP endpoints.

Base URL​

https://api.briefcasebrain.com

Health​

GET /health​

Returns service and storage liveness.

{
  "status": "healthy",
  "storage_healthy": true,
  "version": "2.1.29",
  "uptime_secs": 0
}

GET /info​

Returns server metadata.

{
  "name": "briefcase-server",
  "version": "2.1.29",
  "rust_version": "1.75+",
  "features": [
    "decision-tracking",
    "replay",
    "policy-validation",
    "diff"
  ]
}

Decisions​

POST /api/v1/decisions​

Create a decision snapshot.

{
  "function_name": "evaluate_claim",
  "module_name": "claims",
  "inputs": [{"value": "claim_data", "type": "json"}],
  "outputs": [{"value": "approved", "type": "string", "confidence": 0.95}],
  "model_params": {
    "name": "gpt-4",
    "version": "0613",
    "provider": "openai",
    "params": {"temperature": 0.1}
  },
  "execution_time_ms": 1250,
  "tags": {"environment": "production"}
}

GET /api/v1/decisions/{id}​

Retrieve one decision.

GET /api/v1/decisions​

List decisions with filters.

ParameterTypeDescription
function_namestringFilter by function
module_namestringFilter by module
model_namestringFilter by model
limitintegerMax results (default 50)
offsetintegerPagination offset

DELETE /api/v1/decisions/{id}​

Delete a decision snapshot.

Replay​

POST /api/v1/replay/{id}​

Replay one decision.

{
  "mode": "tolerant",
  "context_overrides": {}
}

Supported modes: strict, tolerant, validation_only.

POST /api/v1/replay/batch​

Replay multiple decisions.

{
  "snapshot_ids": ["dec_abc123", "dec_def456"],
  "mode": "tolerant",
  "concurrency": 4
}

POST /api/v1/replay/{id}/validate​

Validate a decision against policy rules.

POST /api/v1/replay/stats​

Return aggregate replay stats for snapshot_ids.

Diff​

POST /api/v1/diff​

Compare two decisions.

{
  "original_id": "dec_abc123",
  "new_id": "dec_def456"
}
{
  "inputs_changed": false,
  "outputs_changed": true,
  "model_params_changed": false,
  "field_changes": [
    {
      "field": "outputs[0].value",
      "change_type": "Modified",
      "old_value": "approved",
      "new_value": "denied"
    }
  ],
  "execution_time_delta_ms": -250
}