---
title: "Start Subscription"
method: POST
path: "/triggers/subscriptions/{subscription_id}/start"
tags: ["Triggers"]
---

# Start Subscription

`POST /triggers/subscriptions/{subscription_id}/start`

## Path parameters

- `subscription_id` string, uuid, required

## Response `200`

Successful Response

- TriggerSubscriptionResponse
  - `count` integer
  - `subscription` TriggerSubscription
    - `flags` TriggerSubscriptionFlags
      - `is_active` boolean
      - `is_valid` boolean
      - `is_test` boolean
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `created_by_id` string, uuid, nullable
    - `updated_by_id` string, uuid, nullable
    - `deleted_by_id` string, uuid, nullable
    - `id` string, uuid, nullable
    - `connection_id` string, uuid, required
    - `trigger_id` string, nullable
    - `data` TriggerSubscriptionData, required
      - `event_key` string, required
      - `trigger_config` object, nullable
      - `inputs_fields` union
        - object
        - string
      - `references` object, nullable
      - `selector` Selector — Selector for extracting specific data from entities. Placed alongside Reference for data extraction from referenced entities. Fields: - **key**: For environment revisions only. Navigates to data.references.<key>, follows the entity pointer found there (e.g. workflow_revision), fetches that entity, then applies path against its data. - **path**: Dot notation path into the resolved entity's data. If key is set, path applies to the secondary entity's data. If key is not set, path applies directly to the referenced entity's data.
        - `key` string, nullable
        - `path` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.net/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/versions/2e1079696f45/schema)
