REST API

{ "error": "Human readable message", "code": "error_code" }

curl https://api.blobrouter.com/health

curl https://api.blobrouter.com/v1/me \
  -H "Authorization: Bearer $BLOBROUTER_API_KEY"

curl -X POST https://api.blobrouter.com/v1/upload/init \
  -H "Authorization: Bearer $BLOBROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "example.jpg",
    "contentType": "image/jpeg",
    "fileSizeBytes": 12345,
    "priority": "hot"
  }'

curl -X POST https://api.blobrouter.com/v1/upload/complete \
  -H "Authorization: Bearer $BLOBROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileId":"FILE_UUID"}'

curl https://api.blobrouter.com/v1/file/FILE_UUID \
  -H "Authorization: Bearer $BLOBROUTER_API_KEY"

curl -X DELETE https://api.blobrouter.com/v1/file/FILE_UUID \
  -H "Authorization: Bearer $BLOBROUTER_API_KEY"

curl -X POST https://api.blobrouter.com/v1/scanner/connect \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "roleArn": "arn:aws:iam::123456789012:role/BlobRouterScanner",
    "externalId": "YOUR_EXTERNAL_ID",
    "regions": ["us-east-1"]
  }'

curl -X POST https://api.blobrouter.com/v1/scanner/scan \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{"connectionId":"CONNECTION_UUID"}'

curl https://api.blobrouter.com/v1/scanner/results/SCAN_UUID \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl https://api.blobrouter.com/v1/scanner/history \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl -X POST https://api.blobrouter.com/v1/scanner/recommendations/REC_UUID/approve \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{"targetProvider":"backblaze-b2"}'

curl https://api.blobrouter.com/v1/scanner/migration/MIGRATION_UUID \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl -X POST https://api.blobrouter.com/v1/providers \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "cloudflare-r2",
    "accessKeyId": "...",
    "secretAccessKey": "...",
    "bucketName": "my-bucket",
    "region": "auto",
    "accountId": "CLOUDFLARE_ACCOUNT_ID"
  }'

curl -X POST https://api.blobrouter.com/v1/providers/test \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare-r2"}'

curl https://api.blobrouter.com/v1/providers/api-key \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl -X POST https://api.blobrouter.com/v1/providers/api-key/regenerate \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST https://api.blobrouter.com/v1/keys/rotate \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{}'

curl https://api.blobrouter.com/v1/analytics/summary \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl https://api.blobrouter.com/v1/analytics/monthly \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl "https://api.blobrouter.com/v1/analytics/routing-history?limit=10&offset=0" \
  -H "Authorization: Bearer $DASHBOARD_JWT"

curl -X POST https://api.blobrouter.com/v1/billing/checkout \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{"plan":"starter"}'

curl -X POST https://api.blobrouter.com/v1/billing/portal \
  -H "Authorization: Bearer $DASHBOARD_JWT" \
  -H "Content-Type: application/json" \
  -d '{}'