---
title: "Pin Trigger"
method: POST
path: "/api/v1/triggers/{trigger_id}/pin"
tags: ["Triggers"]
---

# Pin Trigger

`POST /api/v1/triggers/{trigger_id}/pin`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `api/v1/login`
  - API key in query parameter `x-api-key`
  - API key in header `x-api-key`

Pin the trigger to a flow version, or unpin it with a null id.

A pin is only accepted for a version of the trigger's own flow: pinning
across flows would let a writer on flow A run flow B's data as A's owner.

## Path parameters

- `trigger_id` string, uuid, required

## Request body

- TriggerPinRequest: Pin or unpin the flow version a trigger fires. ``flow_version_id=None`` unpins, which is why the field is required and explicitly nullable rather than optional: an empty body must not silently unpin.
  - `flow_version_id` string, uuid, nullable, required

## Response `200`

Successful Response

- TriggerRead
  - `binding_target` string, required
  - `concurrency_limit` integer, required
  - `config` object, required
  - `connection_id` string, uuid, nullable, required
  - `created_at` string, date-time, nullable, required
  - `deployment_id` string, uuid, nullable, required
  - `flow_id` string, uuid, required
  - `flow_version_id` string, uuid, nullable, required
  - `id` string, uuid, required
  - `kind` string, required
  - `last_error` string, nullable, required
  - `last_fired_at` string, date-time, nullable, required
  - `max_attempts` integer, required
  - `name` string, required
  - `next_fire_at` string, date-time, nullable, required
  - `node_id` string, nullable, required
  - `provider` string, nullable, required
  - `session_policy` string, required
  - `state` string, required
  - `updated_at` string, date-time, nullable, required
  - `user_id` string, uuid, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `4349fbe90c64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/triggers/:trigger_id/pin/post.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) - [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/4349fbe90c64?raw)