---
title: "Query AlertConfigurations"
method: GET
path: "/alerts/configurations"
tags: ["Alert"]
---

# Query AlertConfigurations

`GET /alerts/configurations`

Used to query AlertConfigurations

## Query parameters

- `parent_namespace` 'accounts' | 'api_keys' | 'workspaces' — Namespace of the parent to which this AlertConfiguration belongs
- `parent_id` string
- `enabled` boolean
- `offset` integer
- `limit` integer

## Response `200`

Results of the query

- AlertConfigurationsQueryResult
  - `alert_configurations` AlertConfiguration[] — All AlertConfigurations that matched the query
    - `id` string — ID of the AlertConfiguration
    - `parent_namespace` 'accounts' | 'api_keys' | 'workspaces' — Namespace of the parent to which this AlertConfiguration belongs
    - `parent_id` string — ID of the parent to which this AlertConfiguration belongs
    - `name` string — Name of the AlertConfiguration
    - `description` string — Description of the AlertConfiguration
    - `trigger_type` 'usage' | 'time_based' — Discriminator for the type of trigger for this AlertConfiguration
    - `trigger` object — Configuration of the trigger for this AlertConfiguration. Type depends on trigger_type (AlertConfigurationUsageTrigger for usage, AlertConfigurationTimeBasedTrigger for time_based)
    - `targets` AlertTarget[] — Configuration of the targets for this AlertConfiguration
      - `medium` 'email' — Medium of the target
      - `target` string — The target
    - `enabled` boolean — Whether or not this configuration is enabled
    - `created_time` integer — Time at which the AlertConfiguration was created
    - `created_by_id` string — The ID of the user who created this AlertConfiguration
    - `last_updated_time` integer — Time at which the AlertConfiguration was last updated
    - `last_updated_by_id` string — The ID of the user who last updated this AlertConfiguration

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

## Changes

> 10 revisions in range; 4 could not be searched.

- **2026-08-19** `f91da75be07c` — 1 warning, 1 info
  - added the new `workspaces` enum value to the `alert_configurations/items/parent_namespace` response property for the response status `200`
  - added the new enum value `workspaces` to the `query` request parameter `parent_namespace`

[Change history](https://skmtc.dev/mabl/apis/mabl-api/changes/alerts/configurations/get.md)

---

[API](https://skmtc.dev/mabl/apis/mabl-api.md) · [All operations](https://skmtc.dev/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/213a66c2bc25/schema)