REST API Reference

The Inferpathio REST API provides programmatic access to all platform functionality. All endpoints require Bearer token authentication.

Authentication

Include your API key in the Authorization header on every request:

Authorization: Bearer ifp_sk_your_key_here

Base URL

https://api.inferpathio.com/v1

Runs

Create a run

POST /runs
{
  "model_name": "fraud-detector",
  "params": {"n_estimators": 100},
  "tags": ["production-candidate"]
}

Log metrics

POST /runs/{run_id}/metrics
{
  "key": "accuracy",
  "value": 0.941,
  "step": 50
}

Register artifact

POST /runs/{run_id}/register
{
  "stage": "staging",
  "artifact_uri": "s3://my-bucket/models/fraud-v4.pkl"
}

Model Registry

List model versions

GET /models/{model_name}/versions?stage=production

Promote version

PATCH /models/{model_name}/versions/{version_id}
{
  "stage": "production"
}

Drift Monitoring

Log inference batch

POST /monitors/{model_name}/log
{
  "features": [[1.2, 0.3, ...], ...],
  "predictions": [0.91, 0.12, ...],
  "window": "2025-12-01T00:00:00Z"
}

Get drift scores

GET /monitors/{model_name}/scores?from=2025-12-01&to=2025-12-08

Rate limits

Free plan: 100 requests/minute. Team: 1,000/minute. Platform: 10,000/minute. Rate limit headers are returned on every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Error codes