POST /usage/summary
POST
/usage/summaryAuthorization
AuthorizationBearer token · headerrequiredRequest body
requiredapplication/jsonwindowstringdefault: "7d"
Allowed:
24h7d30dscopestringdefault: "self"
Allowed:
selfallorgSlugstringmin length 1 · max length 64 · matches ^[a-z0-9][a-z0-9-]*$
Responses
200OK
windowobjectrequiredShow propertiesHide properties
labelstringrequiredAllowed:
24h7d30dsincenumberrequireduntilnumberrequiredscopestringrequiredAllowed:
selfallownersobject[]requiredShow propertiesHide properties
Array of
objectclassstringrequiredAllowed:
useranonnoneownerKeystringrequiredsurfacesobject[]requiredShow propertiesHide properties
Array of
objectsurfacestringrequiredopstringrequiredmetricstringrequiredvaluenumberrequiredestimatedCostUsdnumberrequiredestimatedCostUsdnumberrequiredestimatedCostUsdnumberrequired400400
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Bad request"
dataobjectShow propertiesHide properties
issuesobject[]Show propertiesHide properties
Array of
objectpathstring | number[]Show propertiesHide properties
Array of
string | numberAny of:
string
stringnumber
numbermessagestringrequiredobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany401401
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Sign in required"
dataobjectobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany403403
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "You do not have access to this resource"
dataobjectShow propertiesHide properties
reasonstringAllowed:
not_a_memberinsufficient_rolescope_missingwrite_frozenobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany404404
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Extension not found"
dataobjectrequiredShow propertiesHide properties
namestringrequiredextensionstringrequiredrefstringobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Run not found"
dataobjectrequiredShow propertiesHide properties
idstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Invitation not found"
dataobjectrequiredShow propertiesHide properties
invitationIdstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Invite not found"
dataobjectobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "API key not found"
dataobjectrequiredShow propertiesHide properties
idstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Repo not found"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Git object not found"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobjectstringrequiredobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany409409
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Extension build provenance verification failed"
dataobjectrequiredShow propertiesHide properties
namestringrequiredreasonstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Git ref already exists"
dataobjectrequiredShow propertiesHide properties
namestringrequiredrefstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Git ref is stale"
dataobjectrequiredShow propertiesHide properties
namestringrequiredrefstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Record migration blocked"
dataobjectrequiredShow propertiesHide properties
namestringrequiredreasonsstring[]requiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Repo already exists"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Cannot delete your last owned organization"
dataobjectrequiredShow propertiesHide properties
slugstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Cannot delete an organization that still owns repos"
dataobjectrequiredShow propertiesHide properties
slugstringrequiredrepoCountintegerrequiredmin 0 · max 9007199254740991
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Organization slug is already taken"
dataobjectrequiredShow propertiesHide properties
slugstringrequiredobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany410410
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Invite is no longer available"
dataobjectrequiredShow propertiesHide properties
reasonstringrequiredAllowed:
revokedexpiredexhaustedrepo_unavailableobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany413413
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Request payload exceeds the supported limit"
dataobjectrequiredShow propertiesHide properties
scopestringrequiredAllowed:
workspace_commitgit_workspace_memorylimitnumberrequiredobservednumberobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany422422
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Extension is invalid"
dataobjectrequiredShow propertiesHide properties
namestringrequiredextensionstringreasonstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Extension build failed"
dataobjectrequiredShow propertiesHide properties
namestringrequiredmessagestringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Run rejected"
dataobjectrequiredShow propertiesHide properties
idstringreasonstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Git ref update is not a fast-forward"
dataobjectrequiredShow propertiesHide properties
namestringrequiredrefstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Invalid git tree"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobjectstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Invalid git parent"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobjectstringrequiredobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany429429
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Too many requests"
dataobjectShow propertiesHide properties
retryAfterMsintegermin 0 · max 9007199254740991
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Quota exceeded"
dataobjectrequiredShow propertiesHide properties
scopestringrequiredAllowed:
anonorgsizelimitnumberrequiredobservednumberprojectednumberobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany502502
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Git remote write failed"
dataobjectrequiredShow propertiesHide properties
namestringrequiredrefstringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Repo import failed"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataany503503
One of:
object
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Extension build service is unavailable"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Repo workspace is required for this git operation"
dataobjectrequiredShow propertiesHide properties
namestringrequiredobject
definedanyrequiredcodeanyrequiredstatusanyrequiredmessagestringrequireddefault: "Usage data is temporarily unavailable"
dataobjectobject
definedanyrequiredcodestringrequiredstatusnumberrequiredmessagestringrequireddataanyRequest
curl -X POST "/api/v1/usage/summary" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"window": "7d",
"scope": "self",
"orgSlug": "string"
}'const response = await fetch("/api/v1/usage/summary", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"window": "7d",
"scope": "self",
"orgSlug": "string"
})
});import requests
response = requests.post(
"/api/v1/usage/summary",
headers={
"Authorization": "Bearer YOUR_TOKEN",
"Content-Type": "application/json"
},
json={
"window": "7d",
"scope": "self",
"orgSlug": "string"
},
)Response
{
"window": {
"label": "24h",
"since": 0,
"until": 0
},
"scope": "self",
"owners": [
{
"class": "user",
"ownerKey": "string",
"surfaces": [
{
"surface": "string",
"op": "string",
"metric": "string",
"value": 0,
"estimatedCostUsd": 0
}
],
"estimatedCostUsd": 0
}
],
"estimatedCostUsd": 0
}{
"defined": true,
"code": "BAD_REQUEST",
"status": 400,
"message": "Bad request",
"data": {
"issues": [
{
"path": [
"string"
],
"message": "string"
}
]
}
}{
"defined": true,
"code": "UNAUTHENTICATED",
"status": 401,
"message": "Sign in required",
"data": {}
}{
"defined": true,
"code": "FORBIDDEN",
"status": 403,
"message": "You do not have access to this resource",
"data": {
"reason": "not_a_member"
}
}{
"defined": true,
"code": "EXTENSION_NOT_FOUND",
"status": 404,
"message": "Extension not found",
"data": {
"name": "string",
"extension": "string",
"ref": "string"
}
}{
"defined": true,
"code": "EXTENSION_PROVENANCE",
"status": 409,
"message": "Extension build provenance verification failed",
"data": {
"name": "string",
"reason": "string"
}
}{
"defined": true,
"code": "INVITE_UNAVAILABLE",
"status": 410,
"message": "Invite is no longer available",
"data": {
"reason": "revoked"
}
}{
"defined": true,
"code": "PAYLOAD_TOO_LARGE",
"status": 413,
"message": "Request payload exceeds the supported limit",
"data": {
"scope": "workspace_commit",
"limit": 0,
"observed": 0
}
}{
"defined": true,
"code": "EXTENSION_INVALID",
"status": 422,
"message": "Extension is invalid",
"data": {
"name": "string",
"extension": "string",
"reason": "string"
}
}{
"defined": true,
"code": "TOO_MANY_REQUESTS",
"status": 429,
"message": "Too many requests",
"data": {
"retryAfterMs": 0
}
}{
"defined": true,
"code": "GIT_REMOTE_WRITE_FAILED",
"status": 502,
"message": "Git remote write failed",
"data": {
"name": "string",
"ref": "string"
}
}{
"defined": true,
"code": "EXTENSION_BUILD_UNAVAILABLE",
"status": 503,
"message": "Extension build service is unavailable",
"data": {
"name": "string"
}
}