---
title: "Query Execution Notifications"
method: GET
path: "/executionNotifications"
tags: ["ExecutionNotification"]
---

# Query Execution Notifications

`GET /executionNotifications`

Query all or a subset of Execution Notifications

## Query parameters

- `workspace_id` string, required
- `notification_type` 'webhook' | 'email'
- `lifecycle_trigger,` string
- `limit` integer
- `cursor` string

## Response `200`

Query result

- ExecutionNotificationQueryResult
  - `execution_notifications` ExecutionNotification[] — Matching Execution Notifications
    - `id` string — Unique identifier
    - `created_time` integer — Creation time, epoch milliseconds GMT
    - `created_by_id` string — Creation User identifier
    - `last_updated_time` integer — Last update time, epoch milliseconds GMT
    - `last_updated_by_id` string — Last updated User identifier
    - `workspace_id` string — Associated Organization identifier
    - `enabled` boolean — Enabled state, true to use Notification on Plan Execution
    - `notification_type` 'webhook' | 'email' — Notification type
    - `lifecycle_triggers` string[] — Triggering events in Plan Execution lifecycle [pre_execution, post_execution]
    - `execution_outcome_triggers` string[] — Triggering Plan Execution outcomes [on_success, on_failure]
    - `execution_contingent` boolean — If true, Plan Execution continues if notification successful (only for pre_execution)
    - `strict_tls` boolean — If true, require strict validation of all TLS connections
    - `name` string — Display name
    - `target_url` string — Endpoint URL to receive POST payload, starting with protocol (e.g. https://)
    - `target_email` string — Email address to receive execution notification
    - `plan_ids` string[] — Plans associated with Notification, if empty, applies to all Workspace Plans
    - `tags` Tag[] — Free text tags associated with entity
      - `name` string, required — tag name
      - `values` string[]
  - `cursor` string — Pagination cursor

## Other responses

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

---

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