---
title: "Get Trigger"
method: GET
path: "/v1/triggers/{trigger_id}"
tags: ["v1", "protected", "triggers"]
---

# Get Trigger

`GET /v1/triggers/{trigger_id}`

Get a specific trigger by ID.

Args:
    trigger_id: The unique identifier of the trigger
    secret_manager: Injected secret manager (to resolve credential presence)
    user_context: Authentication context
    trigger_service: Injected trigger service

Returns:
    The trigger data

Raises:
    HTTPException: If trigger not found

## Path parameters

- `trigger_id` string, uuid, required

## Response `200`

Successful Response

- TriggerResponse — Response model for trigger data.
  - `agent_id` string, uuid, required
  - `allowed_methods` string[], nullable
  - `conditions` object, required
  - `consecutive_failures` integer, required
  - `created_at` string, required
  - `created_by` string, required
  - `cron_expression` string, nullable
  - `data_extractor` string, nullable
  - `description` string, required
  - `event_types` string[]
  - `failure_threshold` integer, required
  - `has_channel_credentials` boolean
  - `id` string, uuid, required
  - `is_active` boolean, required
  - `last_execution_at` string, nullable
  - `name` string, required
  - `next_run_time` string, nullable
  - `task_parameters` object, required
  - `timezone` string, nullable
  - `trigger_type` string, required
  - `updated_at` string, required
  - `validation_rules` object, nullable
  - `webhook_config` object, nullable
  - `webhook_id` string, nullable
  - `webhook_type` string, nullable

## Other responses

- `422` — Validation Error

## Changes

> 20 revisions in range; 1 not diffed, 4 could not be searched.

- **2026-07-08** `8940d7f77282` — 4 breaking
  - the `created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `last_execution_at/anyOf[subschema #1]/` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `next_run_time/anyOf[subschema #1]/` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `updated_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
- **2026-04-29** `e1a530c0a2d5` — 1 info
  - added the optional property `data_extractor` to the response with the `200` status
- **2026-03-30** `e9c153221160` — 1 warning
  - removed the optional property `data_extractor` from the response with the `200` status

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/triggers/:trigger_id/get.md)

---

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