Observability / Org Limits
sfp server API reference for Observability / Org Limits: 3 endpoints.
/sfp/api/observability/limits/summaryReturns all monitoring-enabled environments with their worst-limit status. Environments are discovered from existing metrics in VictoriaMetrics.
Authorization
access-token In: header
Query Parameters
Repository identifier in format owner/repo. When omitted, returns a tenant-wide summary across every monitored environment.
Response Body
application/json
curl -X GET "https://example.com/sfp/api/observability/limits/summary"[ { "orgUsername": "admin@company.com", "environmentLabels": [ { "name": "prod", "repositoryIdentifier": "flxbl-io/sf-core" } ], "status": "warning", "lastPolledAt": "2026-02-14T10:30:00Z", "worstLimit": { "name": "DailyApiRequests", "usagePct": 85.5, "alertLevel": "warning" } }]/sfp/api/observability/limits/dashboardReturns time-series chart data, current snapshot table, and alerts for a specific environment. Results are cached based on the time range type.
Authorization
access-token In: header
Query Parameters
Salesforce org username — the primary key for org limits. When provided, the dashboard resolves directly to this org and environmentName/repositoryIdentifier are ignored.
Environment name (legacy — resolves to its org). Optional when org is provided.
Repository identifier in format owner/repo (legacy). Optional when org is provided.
Time range for metrics
Value in
- "today"
- "yesterday"
- "last_7_days"
Force refresh - bypass cache and fetch fresh data
falseResponse Body
application/json
curl -X GET "https://example.com/sfp/api/observability/limits/dashboard?range=today"{ "meta": { "range": "today", "rangeLabel": "Today", "start": "2026-02-14T00:00:00Z", "end": "2026-02-14T12:30:00Z", "environmentName": "prod", "repositoryIdentifier": "flxbl-io/sf-core", "generatedAt": "2026-02-14T12:30:00Z", "cached": false, "queryDurationMs": 125 }, "timeSeries": [ { "limitName": "DailyApiRequests", "dataPoints": [ { "timestamp": "2026-02-14T10:00:00Z", "usagePct": 31.85 } ] } ], "snapshot": [ { "name": "DailyApiRequests", "max": 15000, "used": 4777, "remaining": 10223, "usagePct": 31.85, "alertLevel": "ok" } ], "alerts": [ { "name": "DailyApiRequests", "max": 15000, "used": 4777, "remaining": 10223, "usagePct": 31.85, "alertLevel": "ok" } ]}/sfp/api/observability/limits/snapshotReturns lightweight current values only (no time-series data).
Authorization
access-token In: header
Query Parameters
Environment name
Repository identifier in format owner/repo
Response Body
application/json
curl -X GET "https://example.com/sfp/api/observability/limits/snapshot?environmentName=prod&repositoryIdentifier=flxbl-io%2Fsf-core"[ { "name": "DailyApiRequests", "max": 15000, "used": 4777, "remaining": 10223, "usagePct": 31.85, "alertLevel": "ok" }]