Skip to main content
GET
Error

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
projectId
string
required

The unique identifier of the Upsun project

Pattern: [a-z0-9]+
Example:

"22sdxmbrs4lai"

​
envId
string
required

The environment identifier

Pattern: .+
Example:

"main"

​
app
string
required

URL-encoded application name

Pattern: .+
Example:

"my-app"

Query Parameters

​
from
integer<int64>

Start of the time range as a Unix timestamp, defaults to now minus 30 minutes.

Example:

1700000000

​
to
integer<int64>

End of the time range as a Unix timestamp, defaults to now.

Example:

1700003600

​
profile_type
enum<string>

Profile type to query.

Available options:
cpu,
wall-time,
wall,
goroutine,
alloc_objects,
alloc_space,
inuse_objects,
inuse_space,
space
Example:

"cpu"

​
runtime_mode
enum<integer>

Filter mode for runtime parameter. "1" (additive) includes only specified runtimes. "-1" (subtractive) excludes specified runtimes and includes all others. When omitted while runtime[] is supplied, defaults to "1" (additive).

Available options:
1,
-1
Example:

1

​
runtime[]
string[]

Filter by runtime language. Can be specified multiple times for multiple values (e.g., ?runtime[]=go&runtime[]=python). Use runtime_mode to control inclusion/exclusion behavior.

​
runtime_version_mode
enum<integer>

Filter mode for runtime_version parameter. "1" (additive) includes only specified versions. "-1" (subtractive) excludes specified versions and includes all others. When omitted while runtime_version[] is supplied, defaults to "1" (additive).

Available options:
1,
-1
Example:

1

​
runtime_version[]
string[]

Filter by runtime version. Can be specified multiple times for multiple values (e.g., ?runtime_version[]=1.21&runtime_version[]=1.22). Use runtime_version_mode to control inclusion/exclusion behavior.

​
runtime_arch_mode
enum<integer>

Filter mode for runtime_arch parameter. "1" (additive) includes only specified architectures. "-1" (subtractive) excludes specified architectures and includes all others. When omitted while runtime_arch[] is supplied, defaults to "1" (additive).

Available options:
1,
-1
Example:

1

​
runtime_arch[]
string[]

Filter by runtime architecture. Can be specified multiple times for multiple values (e.g., ?runtime_arch[]=amd64&runtime_arch[]=arm64). Use runtime_arch_mode to control inclusion/exclusion behavior.

​
runtime_os_mode
enum<integer>

Filter mode for runtime_os parameter. "1" (additive) includes only specified operating systems. "-1" (subtractive) excludes specified operating systems and includes all others. When omitted while runtime_os[] is supplied, defaults to "1" (additive).

Available options:
1,
-1
Example:

1

​
runtime_os[]
string[]

Filter by runtime operating system. Can be specified multiple times for multiple values (e.g., ?runtime_os[]=linux&runtime_os[]=darwin). Use runtime_os_mode to control inclusion/exclusion behavior.

​
probe_version_mode
enum<integer>

Filter mode for probe_version parameter. "1" (additive) includes only specified probe versions. "-1" (subtractive) excludes specified probe versions and includes all others. When omitted while probe_version[] is supplied, defaults to "1" (additive).

Available options:
1,
-1
Example:

1

​
probe_version[]
string[]

Filter by probe version. Can be specified multiple times for multiple values (e.g., ?probe_version[]=2.28.2&probe_version[]=2.28.1). Use probe_version_mode to control inclusion/exclusion behavior.

Response

Timeline data retrieved successfully

​
from
integer<int64>
required

Actual start of the time range as a Unix timestamp

Example:

1700000000

​
to
integer<int64>
required

Actual end of the time range as a Unix timestamp

Example:

1700003600

​
grain
integer
required

Granularity of data points in seconds

Example:

1800

​
unit
string
required

Unit of the sample values, suffixed with _per_second for sum aggregation types

Example:

"nanoseconds_per_second"

​
aggregation_type
enum<string>
required
Available options:
avg,
sum
Example:

"sum"

​
retention
integer
required

Agent retention period in minutes

Example:

80640

​
points
object[]
required
Last modified on June 16, 2026