Get Runs Chart Data

curl --request GET \
  --url https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "aggregatedData": "<array>",
  "groupBy": "<string>",
  "items": "<array>",
  "nextToken": "<string>",
  "timeRange": "<string>",
  "total": 123
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

GET

projects

{project_id}

apps

{app_id}

runs

charts

Get Runs Chart Data

curl --request GET \
  --url https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://rest.cerebrium.ai/v2/projects/{project_id}/apps/{app_id}/runs/charts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "aggregatedData": "<array>",
  "groupBy": "<string>",
  "items": "<array>",
  "nextToken": "<string>",
  "timeRange": "<string>",
  "total": 123
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Service Account Token authentication. To authenticate API requests:

Create a Service Account Token:
- Go to the Cerebrium Dashboard and open the API Keys page
- Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
- Copy the token generated for the desired service account
Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>
Best Practices:
- Create separate service accounts for different environments (dev, staging, prod)
- Store tokens securely as secrets in consuming applications or workflows
- Set appropriate expiry dates and rotate tokens regularly
- Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id

string

required

app_id

string

required

Query Parameters

startDate

string

required

Start of the time range, in RFC3339 format.

endDate

string

required

End of the time range, in RFC3339 format.

limit

integer

Maximum number of individual runs to return when not aggregating. Must be > 0. Default: 100.

offset

integer

Number of runs to skip when not aggregating. Must be >= 0. Default: 0.

status

string

Filter runs by status. Valid values: pending, proxyQueued, containerQueued, processing, success, failure, cancelled.

statusCode

integer

Filter runs by HTTP status code.

groupBy

string

Time bucket for aggregated results. Valid values: minute, hour, day.

aggregate

boolean

Set to true to return aggregated counts instead of individual runs. Time ranges longer than 24 hours are aggregated automatically.

minStartupTimeMs

integer

Only include runs with a startup time of at least this many milliseconds.

maxStartupTimeMs

integer

Only include runs with a startup time of at most this many milliseconds.

minResponseTimeMs

integer

Only include runs with a response time of at least this many milliseconds.

maxResponseTimeMs

integer

Only include runs with a response time of at most this many milliseconds.

string

IANA timezone used for time bucketing (e.g. America/New_York). Default: UTC.

Response

Run data for charting, either individual runs or aggregated time buckets.

aggregatedData

array

Aggregated counts per time bucket, when aggregating. Each item includes timeGroup, startTime, endTime, request counts (totalRequests, successfulRequests, failedRequests, cancelledRequests, proxyQueued, containerQueued, processing), successRate (number), and timing statistics in milliseconds (avg, p50, p90, p99, min, and max for runtime and response time, plus avgColdstartTimeMs and avgQueueTimeMs). Omitted when not aggregating.

groupBy

string

The time bucket size used for aggregation. Omitted when not aggregating.

items

array

Individual runs, when not aggregating. Each item has id, projectId, modelId, podName, coldstartTimeMs (integer), totalQueueTimeMs (integer), runtimeMs (number), totalResponseTimeMs (number), statusCode (integer), createdAt, and updatedAt fields. Omitted when aggregating.

nextToken

string

Pagination token for the next page. Omitted when there are no more results.

timeRange

string

The time range covered by the aggregated results. Omitted when not aggregating.

total

integer

Total number of runs matching the query.

⌘I

Builds

Projects

API Keys

Apps

Containers

Metrics

Runs

Secrets

Billing

Custom Domains

Subscriptions

Service Accounts

Users

Volumes

Files

Cerebrium Run

Integrations

Get Runs Chart Data

Authorizations

Path Parameters

Query Parameters

Response