Config
Retrieve retained usage by resource, account or execution.
Details are retained for at least 90 days. Older resource summaries use UTC day buckets; accounts and individual executions are unavailable outside detail retention.
GET
/
api
/
v1
/
config
/
instance
/
usage
/
executions
Retrieve retained usage by resource, account or execution.
curl --request GET \
--url https://api.revoengine.com/api/v1/config/instance/usage/executions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revoengine.com/api/v1/config/instance/usage/executions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/config/instance/usage/executions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"selectedPeriod": {
"from": "2026-08-01T00:00:00.000Z",
"to": "2026-08-14T00:00:00.000Z"
},
"retention": {
"detailDays": 91,
"detailFrom": "2023-11-07T05:31:56Z",
"selectedPeriodDetailed": true,
"granularity": "exact",
"effectiveFrom": "2023-11-07T05:31:56Z",
"effectiveTo": "2023-11-07T05:31:56Z"
},
"kind": "job",
"view": "resources",
"rows": [
{
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123,
"id": "<string>",
"name": "<string>",
"userId": "<string>",
"userName": "<string>",
"resourceId": "<string>",
"resourceName": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"total": 123,
"skip": 123,
"take": 123,
"hasMore": true,
"summary": {
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123
},
"series": [
{
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123,
"period": "2023-12-25"
}
]
}Authorizations
Bearer JWT token or API Key (sk-*).
Query Parameters
Inclusive lower UTC timestamp for usage analytics. Defaults to the start of the current UTC month.
Example:
"2026-08-01T00:00:00.000Z"
Exclusive upper UTC timestamp for usage analytics. Defaults to the current time.
Example:
"2026-09-01T00:00:00.000Z"
Available options:
job, endpoint, webhook Available options:
resources, accounts, executions Required range:
0 <= x <= 10000Required range:
1 <= x <= 100Response
200 - application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
job, endpoint, webhook Available options:
resources, accounts, executions Show child attributes
Show child attributes
Null when the requested detailed projection is outside retained history.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Last modified on October 5, 2026
⌘I
Retrieve retained usage by resource, account or execution.
curl --request GET \
--url https://api.revoengine.com/api/v1/config/instance/usage/executions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.revoengine.com/api/v1/config/instance/usage/executions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/config/instance/usage/executions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"selectedPeriod": {
"from": "2026-08-01T00:00:00.000Z",
"to": "2026-08-14T00:00:00.000Z"
},
"retention": {
"detailDays": 91,
"detailFrom": "2023-11-07T05:31:56Z",
"selectedPeriodDetailed": true,
"granularity": "exact",
"effectiveFrom": "2023-11-07T05:31:56Z",
"effectiveTo": "2023-11-07T05:31:56Z"
},
"kind": "job",
"view": "resources",
"rows": [
{
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123,
"id": "<string>",
"name": "<string>",
"userId": "<string>",
"userName": "<string>",
"resourceId": "<string>",
"resourceName": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"total": 123,
"skip": 123,
"take": 123,
"hasMore": true,
"summary": {
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123
},
"series": [
{
"count": 123,
"processingMs": 123,
"failures": 123,
"averageDurationMs": 123,
"period": "2023-12-25"
}
]
}
