> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beta.adapter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List trigger registry

<Snippet file="api/Triggers/list-trigger-kinds.mdx" />


## OpenAPI

````yaml GET /v1/triggers/kinds
openapi: 3.1.0
info:
  title: Adapter API
  description: Connect and sync data from any SaaS tool.
  version: 0.1.0
servers:
  - url: https://api.adapter.com
security:
  - ApiKeyAuth: []
tags:
  - name: connections
    description: Manage OAuth connections to data sources.
paths:
  /v1/triggers/kinds:
    get:
      tags:
        - Triggers
      summary: List trigger registry
      operationId: list_trigger_kinds
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerKindsResponse'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationErrorModel'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PermissionDeniedErrorModel'
          description: Forbidden
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorModel'
          description: Internal Server Error
components:
  schemas:
    TriggerKindsResponse:
      properties:
        source_kinds:
          items:
            $ref: '#/components/schemas/TriggerKindOut'
          type: array
          title: Source Kinds
          description: >-
            Kinds you can subscribe to today — both connector-data kinds and
            entity kinds.
        templates:
          items:
            $ref: '#/components/schemas/TriggerKindOut'
          type: array
          title: Templates
          description: >-
            Higher-level classifiers for the upcoming Watch picker (coming soon,
            not yet subscribable).
      type: object
      required:
        - source_kinds
        - templates
      title: TriggerKindsResponse
    AuthenticationErrorModel:
      properties:
        error_code:
          type: string
          const: authentication_error
          title: Error Code
          default: authentication_error
        message:
          type: string
          title: Message
          default: Invalid or missing credentials.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: AuthenticationErrorModel
    PermissionDeniedErrorModel:
      properties:
        error_code:
          type: string
          const: permission_denied
          title: Error Code
          default: permission_denied
        message:
          type: string
          title: Message
          default: You do not have permission to perform this action.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: PermissionDeniedErrorModel
    InternalServerErrorModel:
      properties:
        error_code:
          type: string
          const: internal_server_error
          title: Error Code
          default: internal_server_error
        message:
          type: string
          title: Message
          default: An unexpected error occurred.
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      title: InternalServerErrorModel
    TriggerKindOut:
      properties:
        id:
          type: string
          title: Id
          description: Registry id — pass this as `kind` when creating a trigger.
          examples:
            - email
        label:
          type: string
          title: Label
          description: Human-readable label.
          examples:
            - Email
        trigger_class:
          type: string
          title: Trigger Class
          description: >-
            Which family this kind belongs to: `connector` for connector-data
            kinds (events from your connected accounts), `knowledge` for entity
            kinds (changes to extracted entities like person or organization),
            and `category` for the cross-source classifiers listed under
            `templates`.
          examples:
            - connector
            - knowledge
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        actions:
          items:
            type: string
          type: array
          title: Actions
          description: >-
            Actions this kind can emit — pass one of these as `action` on a
            trigger. Only kinds that track supercession emit `updated`.
          examples:
            - - created
              - updated
              - deleted
        offers:
          items:
            $ref: '#/components/schemas/TriggerKindOfferOut'
          type: array
          title: Offers
          description: >-
            Provider + resource combinations that produce this kind. Empty for
            entity kinds — those aren't scoped to a specific connector.
        predicate_fields:
          items:
            $ref: '#/components/schemas/TriggerPredicateFieldOut'
          type: array
          title: Predicate Fields
          description: >-
            Fields on this kind's event payload you can reference from a
            trigger's `filter` to build deeper rules — path, type, and (when
            applicable) allowed values.
      type: object
      required:
        - id
        - label
        - trigger_class
      title: TriggerKindOut
    TriggerKindOfferOut:
      properties:
        provider:
          type: string
          title: Provider
          description: Provider slug, matches Connection.provider.
          examples:
            - google
        provider_label:
          type: string
          title: Provider Label
          description: Provider display name.
          examples:
            - Google
        resource:
          type: string
          title: Resource
          description: >-
            Resource slug that must be enabled on a connection for this kind to
            produce events.
          examples:
            - calendar
      type: object
      required:
        - provider
        - provider_label
        - resource
      title: TriggerKindOfferOut
    TriggerPredicateFieldOut:
      properties:
        path:
          type: string
          title: Path
          description: Dotted path into the event's `data` payload.
          examples:
            - sender.email
        label:
          type: string
          title: Label
          description: Human-readable label.
          examples:
            - Sender email
        type:
          type: string
          title: Type
          description: >-
            Field type — controls which operators apply in the predicate
            builder.
          examples:
            - string
            - email
            - datetime
            - integer
            - number
            - boolean
            - array_string
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        enum:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Enum
          description: >-
            If set, the field accepts one of these values — surfaces as a
            dropdown in the picker.
      type: object
      required:
        - path
        - label
        - type
      title: TriggerPredicateFieldOut
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: Pass your `pk_live_...` API key as a Bearer token.

````