Skip to main content
GET
/
projects
/
{projectId}
/
environments
/
{envId}
/
continuous-profiling
/
app
/
{app}
/
filter
Error
A valid request URL is required to generate request examples
{
  "fields": {
    "runtime": {
      "distinct_values": 2,
      "values": [
        {
          "value": "go",
          "count": 1500
        },
        {
          "value": "python",
          "count": 500
        }
      ]
    },
    "runtime_version": {
      "distinct_values": 3,
      "values": [
        {
          "value": "1.21",
          "count": 1000
        },
        {
          "value": "1.22",
          "count": 400
        },
        {
          "value": "3.12",
          "count": 600
        }
      ]
    }
  },
  "max_applicable_filters": 45
}

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.

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

Filter values retrieved successfully

​
fields
object
required

Map of filter field name to its distinct values and counts

Example:
{
  "runtime": {
    "distinct_values": 2,
    "values": [
      { "value": "go", "count": 1500 },
      { "value": "python", "count": 500 }
    ]
  },
  "runtime_version": {
    "distinct_values": 3,
    "values": [
      { "value": "1.21", "count": 1000 },
      { "value": "1.22", "count": 400 },
      { "value": "3.12", "count": 600 }
    ]
  }
}
​
max_applicable_filters
integer
required

Maximum number of applicable filters

Example:

45

Last modified on April 10, 2026