Get Organization Usage
get
/v1/orgs/{org_id}/usagePart of Org Usage.
Aggregated across all graphs in the org. Use the days query param to control the lookback window (default 30).
Authentication
Authenticate in any one of these ways — not all of them:
- API key in the
X-API-Keyheader. - Bearer token in the
Authorizationheader.
Path parameters
| Name | Type | Description |
|---|---|---|
org_idrequired | string | Org Id |
Query parameters
| Name | Type | Description |
|---|---|---|
daysoptional | integer | Days Default: |
Example request
curl
curl -X GET "https://api.robosystems.ai/v1/orgs/{org_id}/usage" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY"Responses
200 Successful Response
| Field | Type | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
org_idrequired | string | |||||||||||||||||||||||||
period_daysrequired | integer | |||||||||||||||||||||||||
start_daterequired | string (date-time) | |||||||||||||||||||||||||
end_daterequired | string (date-time) | |||||||||||||||||||||||||
summaryrequired | OrgUsageSummary | Organization usage summary. OrgUsageSummary fields
| ||||||||||||||||||||||||
graph_detailsrequired | object[] | |||||||||||||||||||||||||
daily_trendrequired | object[] |
| Status | Meaning |
|---|---|
| 400 | Invalid request |
| 401 | Authentication required |
| 403 | Access denied |
| 404 | Resource not found |
| 422 | Validation Error |
| 429 | Rate limit exceeded |
| 500 | Internal server error |