Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{envId}
/
continuous-profiling
/
app
/
{app}
/
merge
Error
A valid request URL is required to generate request examples
"<string>"

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"

​
out
enum<string>

Output format for the merged profile.

Available options:
pprof,
dot,
flamebearerv2
Example:

"pprof"

​
runtime_mode
enum<integer>

Filter mode for runtime parameter. "1" (additive) includes only specified runtimes. "-1" (subtractive) excludes specified runtimes and includes all others.

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.

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.

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.

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.

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

Merged profile retrieved successfully

Gzipped pprof protobuf when out=pprof

Last modified on April 10, 2026