コンテンツにスキップ

List alert rules

GET
/v1/projects/{id}/alerts

Returns all alert rules for the specified project, including joined map names, threshold profile names, latest evaluation status, and notification channel IDs.

id
required
string format: uuid

Project UUID.

Array of alert rules.

object
success
boolean
data
Array<object>

Alert rule with joined display names and latest status.

object
id
string format: uuid
name
string
mapId
string format: uuid
mapName

Display name of the associated map (joined).

string | null
thresholdProfileId
string format: uuid
thresholdProfileName

Display name of the threshold profile (joined).

string | null
metric
string
Allowed values: fps frame_time memory gpu_time
thresholdLevel
string
Allowed values: warn good
failPercentage

Percentage of cells that must fail to trigger (1-100).

number
evaluationDays

Number of days of data to evaluate.

integer
cellSize

Grid cell size used for evaluation.

integer
cooldownMinutes

Minimum minutes between notifications.

integer
isActive
boolean
createdAt
string format: date-time
latestStatus

Status from the most recent evaluation (triggered or resolved).

string | null
thresholdProfileIds

The rule’s effective threshold profile bundle (1 to 10 profiles), each evaluated independently. The first element is the primary profile (thresholdProfileId).

Array<string>
profileStatuses

Per-profile evaluation status and device filters, one entry per member of thresholdProfileIds. The rule-level latestStatus is triggered if any member is triggered, else resolved if any is resolved, else null.

Array<object>

Latest evaluation status and device filters for one profile in an alert rule’s bundle.

object
profileId
required
string format: uuid
profileName

Display name of the profile; null if the profile was deleted.

string | null
status

Latest status for this rule-profile pair, or null if it has not been evaluated yet.

string | null
Allowed values: triggered resolved
platform

Profile platform filter; null matches any platform.

string | null
resolution

Profile resolution filter; null matches any resolution.

string | null
buildConfig

Profile build configuration filter; null matches any build configuration.

string | null
gpu

Profile GPU model filter; null matches any GPU.

string | null
storage

Profile storage type filter; null matches any storage.

string | null
channelIds

Notification channel UUIDs.

Array<string>
X-RateLimit-Limit
integer

Maximum number of requests allowed per hour.

X-RateLimit-Remaining
integer

Number of requests remaining in the current window.

X-RateLimit-Reset
integer

Unix timestamp when the rate limit window resets.

Missing or invalid API key.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object
type
required

Problem type URI; about:blank when no specific type applies.

string format: uri
default: about:blank
title
required

Short, human-readable summary of the problem type.

string
status
required

HTTP status code.

integer
detail

Human-readable explanation specific to this occurrence.

string
error_category

Extension member categorizing the error.

string
Allowed values: authentication authorization validation rate_limit not_found conflict payload internal
retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean
retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

Resource not found.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object
type
required

Problem type URI; about:blank when no specific type applies.

string format: uri
default: about:blank
title
required

Short, human-readable summary of the problem type.

string
status
required

HTTP status code.

integer
detail

Human-readable explanation specific to this occurrence.

string
error_category

Extension member categorizing the error.

string
Allowed values: authentication authorization validation rate_limit not_found conflict payload internal
retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean
retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer

Rate limit exceeded.

RFC 9457 Problem Details. Served with the application/problem+json media type. error_category, retryable, and retry_after are Framedash extension members. type always defaults to about:blank, so it is always present; detail and the extension members are present only when applicable.

object
type
required

Problem type URI; about:blank when no specific type applies.

string format: uri
default: about:blank
title
required

Short, human-readable summary of the problem type.

string
status
required

HTTP status code.

integer
detail

Human-readable explanation specific to this occurrence.

string
error_category

Extension member categorizing the error.

string
Allowed values: authentication authorization validation rate_limit not_found conflict payload internal
retryable

Extension member; true when retrying may succeed (e.g. 429, 503).

boolean
retry_after

Extension member; suggested retry delay in seconds, when applicable.

integer
X-RateLimit-Limit
integer

Maximum number of requests allowed per hour.

X-RateLimit-Remaining
integer

Number of requests remaining in the current window.

X-RateLimit-Reset
integer

Unix timestamp when the rate limit window resets.

Retry-After
integer

Number of seconds to wait before retrying. Present only on 429 responses. Because the limit uses a sliding window, honor this value per response rather than scheduling a retry for the reset time.