---
title: "Get trigger preset"
method: GET
path: "/api/trigger-presets/{preset_id}"
tags: ["Triggers"]
---

# Get trigger preset

`GET /api/trigger-presets/{preset_id}`

Retrieve a single trigger preset by id.

## Path parameters

- `preset_id` string, required

## Response `200`

Successful response.

- PlatformTriggerPresetGetResponse
  - `trigger_preset` PlatformTriggerPreset, required
    - `preset_id` string, required — ID of the preset. Pass this when creating a trigger.
    - `datasource` string, required — Datasource the preset fires on.
    - `display_name` string, required — Human-readable preset name.
    - `description` string — Human-readable description of when the preset fires.
    - `inputs` PlatformTriggerPresetInput[], required — Inputs the caller may supply when creating a trigger from this preset.
      - `field` string, required — Identifier of the input, supplied as a key in the trigger's `inputs`.
      - `type` 'PICKLIST' | 'TEXT' | 'USER', required — Type of a preset input.
      - `display_name` string, required — Human-readable name for the input.
      - `is_required` boolean, required — Whether the caller must supply a value for this input.
      - `values` PlatformTriggerPresetInputValue[] — Bounded initial set of selectable values for a picklist input. Omitted entirely for free-text inputs.
        - `value` string, required — The exact value to send in the trigger's `inputs` for this choice (e.g. a channel name, a user's email, etc).
        - `display_name` string, required — Human-readable name for this value.
      - `is_truncated` boolean — Whether additional selectable values were omitted from `values`. When true, use GET /trigger-presets/{preset_id}/input-values with a query to narrow the result set.
  - `request_id` string, required — Platform-generated request ID for support correlation.

## Other responses

- `400` — Invalid request (malformed JSON, invalid parameter values, unknown fields).
- `401` — Missing or invalid authentication token.
- `403` — Token valid but lacks permission for the requested operation.
- `404` — Resource not found.
- `408` — Backend did not respond within the timeout window.
- `429` — Rate limit exceeded. Includes Retry-After header.
- `500` — Unexpected server-side failure.
- `503` — Backend temporarily unavailable.

---

[API](https://skmtc.dev/gleanwork/apis/glean-platform-api.md) · [All operations](https://skmtc.dev/gleanwork/apis/glean-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gleanwork/glean-platform-api/revisions/46c121f70527/schema)