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

# List triggers

> Requires the triggers:read scope.

Accepts a scoped bearer token, vendor-verified run identity, or interactive owner session.



## OpenAPI

````yaml /openapi.yaml get /api/v1/triggers
openapi: 3.1.0
info:
  title: Factorize API
  version: 1.0.0
  description: >-
    Versioned Factorize REST API. See the hosted docs for examples and OAuth
    discovery.
  x-dashboard-auth: >-
    Access-token and authorized-client management and trace replay operations
    require an interactive owner session; all other operations accept a suitably
    scoped bearer token or owner session.
servers:
  - url: https://app.factorize.sh
security:
  - bearerAuth: []
paths:
  /api/v1/triggers:
    get:
      tags:
        - triggers
      summary: List triggers
      description: >-
        Requires the triggers:read scope.


        Accepts a scoped bearer token, vendor-verified run identity, or
        interactive owner session.
      operationId: get_api_v1_triggers
      responses:
        '200':
          description: Triggers
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                      pattern: >-
                        ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                    name:
                      type: string
                    enabled:
                      type: boolean
                    requiresVm:
                      type: boolean
                    executionType:
                      type: string
                      enum:
                        - agent
                        - code
                    prompt:
                      type: string
                    script:
                      type: string
                    runNameTemplate:
                      type: string
                    tags:
                      type: array
                      items:
                        type: string
                    model:
                      type: string
                    effort:
                      type: string
                    executionConfig:
                      type: object
                      properties:
                        connectionId:
                          type: string
                        requiresVm:
                          type: boolean
                        workspace:
                          type: string
                        cwd:
                          type: string
                        agentKind:
                          type: string
                        image:
                          type: string
                        region:
                          type: string
                        size:
                          type: string
                        executionType:
                          type: string
                          enum:
                            - agent
                            - code
                        script:
                          type: string
                      required:
                        - connectionId
                        - agentKind
                      additionalProperties: false
                    runScopes:
                      type: array
                      items:
                        type: string
                        enum:
                          - team:read
                          - team:write
                          - triggers:read
                          - triggers:write
                          - runs:read
                          - runs:invoke
                          - runs:start
                          - runs:cancel
                          - runs:write
                          - integrations:read
                          - integrations:write
                          - skills:read
                          - skills:write
                    portableIntegrationIds:
                      type: array
                      items:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                    modelAccountId:
                      type: string
                      format: uuid
                      pattern: >-
                        ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                    githubInstallationIds:
                      type: array
                      items:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                    linearConnectionId:
                      anyOf:
                        - type: string
                          const: linear
                        - type: 'null'
                    xConnectionIds:
                      type: array
                      items:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                    skillId:
                      anyOf:
                        - type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                        - type: 'null'
                    executionConfigId:
                      type: string
                    agentKind:
                      type: string
                    concurrencyLimit:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                    runningCount:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                    currentRuns:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                    maxConcurrency:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                    lastRunState:
                      anyOf:
                        - type: string
                          enum:
                            - queued
                            - reserved
                            - starting
                            - running
                            - blocked
                            - stopping
                            - succeeded
                            - failed
                            - stopped
                            - done
                            - ignored
                        - type: 'null'
                    events:
                      type: array
                      items:
                        oneOf:
                          - type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              slug:
                                type: string
                              kind:
                                type: string
                                const: manual
                              template:
                                type: string
                                maxLength: 50000
                              enabled:
                                default: true
                                type: boolean
                              config:
                                default: {}
                                type: object
                                properties: {}
                                additionalProperties: false
                              triggerId:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              createdAt:
                                type: string
                              updatedAt:
                                type: string
                            required:
                              - id
                              - slug
                              - kind
                              - enabled
                              - config
                              - triggerId
                              - createdAt
                              - updatedAt
                            additionalProperties: false
                          - type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              slug:
                                type: string
                              kind:
                                type: string
                                const: schedule
                              template:
                                type: string
                                maxLength: 50000
                              enabled:
                                default: true
                                type: boolean
                              config:
                                type: object
                                properties:
                                  cron:
                                    type: string
                                    minLength: 1
                                  timezone:
                                    type: string
                                    minLength: 1
                                required:
                                  - cron
                                  - timezone
                                additionalProperties: false
                              triggerId:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              createdAt:
                                type: string
                              updatedAt:
                                type: string
                            required:
                              - id
                              - slug
                              - kind
                              - enabled
                              - config
                              - triggerId
                              - createdAt
                              - updatedAt
                            additionalProperties: false
                          - type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              slug:
                                type: string
                              kind:
                                type: string
                                const: webhook
                              template:
                                type: string
                                maxLength: 50000
                              enabled:
                                default: true
                                type: boolean
                              config:
                                oneOf:
                                  - type: object
                                    properties:
                                      conditions:
                                        type: object
                                        propertyNames:
                                          type: string
                                        additionalProperties: {}
                                      provider:
                                        type: string
                                        const: linear
                                      projectId:
                                        type: string
                                        minLength: 1
                                      matchRules:
                                        minItems: 1
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            type:
                                              type: string
                                              enum:
                                                - owner
                                                - creator
                                                - status
                                                - label
                                                - assignee
                                            targetId:
                                              type: string
                                              minLength: 1
                                          required:
                                            - type
                                            - targetId
                                          additionalProperties: false
                                      secretConfigured:
                                        type: boolean
                                    required:
                                      - provider
                                      - projectId
                                      - matchRules
                                    additionalProperties: false
                                  - type: object
                                    properties:
                                      conditions:
                                        type: object
                                        propertyNames:
                                          type: string
                                        additionalProperties: {}
                                      provider:
                                        type: string
                                        const: clickup
                                      listId:
                                        type: string
                                        minLength: 1
                                      matchRules:
                                        minItems: 1
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            type:
                                              type: string
                                              enum:
                                                - owner
                                                - creator
                                                - status
                                                - label
                                                - assignee
                                            targetId:
                                              type: string
                                              minLength: 1
                                          required:
                                            - type
                                            - targetId
                                          additionalProperties: false
                                      secretConfigured:
                                        type: boolean
                                    required:
                                      - provider
                                      - listId
                                      - matchRules
                                    additionalProperties: false
                                  - type: object
                                    properties:
                                      conditions:
                                        type: object
                                        propertyNames:
                                          type: string
                                        additionalProperties: {}
                                      provider:
                                        type: string
                                        const: github
                                      installationId:
                                        type: integer
                                        exclusiveMinimum: 0
                                        maximum: 9007199254740991
                                      repositoryId:
                                        type: integer
                                        exclusiveMinimum: 0
                                        maximum: 9007199254740991
                                      event:
                                        type: string
                                        minLength: 1
                                      action:
                                        type: string
                                        minLength: 1
                                      matchRules:
                                        minItems: 1
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            type:
                                              type: string
                                              enum:
                                                - owner
                                                - creator
                                                - status
                                                - label
                                                - assignee
                                            targetId:
                                              type: string
                                              minLength: 1
                                          required:
                                            - type
                                            - targetId
                                          additionalProperties: false
                                      secretConfigured:
                                        type: boolean
                                    required:
                                      - provider
                                      - installationId
                                      - repositoryId
                                    additionalProperties: false
                                  - type: object
                                    properties:
                                      conditions:
                                        type: object
                                        propertyNames:
                                          type: string
                                        additionalProperties: {}
                                      provider:
                                        type: string
                                        const: cloudflareTail
                                      integrationId:
                                        type: string
                                        minLength: 1
                                      destination:
                                        type: string
                                      secretConfigured:
                                        type: boolean
                                    required:
                                      - provider
                                      - integrationId
                                    additionalProperties: false
                              triggerId:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              createdAt:
                                type: string
                              updatedAt:
                                type: string
                            required:
                              - id
                              - slug
                              - kind
                              - enabled
                              - config
                              - triggerId
                              - createdAt
                              - updatedAt
                            additionalProperties: false
                          - type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              slug:
                                type: string
                              kind:
                                type: string
                                const: triggerLifecycle
                              template:
                                type: string
                                maxLength: 50000
                              enabled:
                                default: true
                                type: boolean
                              config:
                                type: object
                                properties:
                                  sourceTriggerIds:
                                    minItems: 1
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                  states:
                                    minItems: 1
                                    type: array
                                    items:
                                      type: string
                                      enum:
                                        - succeeded
                                        - failed
                                        - stopped
                                        - edited
                                required:
                                  - sourceTriggerIds
                                  - states
                                additionalProperties: false
                              triggerId:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              createdAt:
                                type: string
                              updatedAt:
                                type: string
                            required:
                              - id
                              - slug
                              - kind
                              - enabled
                              - config
                              - triggerId
                              - createdAt
                              - updatedAt
                            additionalProperties: false
                          - type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              slug:
                                type: string
                              kind:
                                type: string
                                const: triggerIdle
                              template:
                                type: string
                                maxLength: 50000
                              enabled:
                                default: true
                                type: boolean
                              config:
                                type: object
                                properties:
                                  sourceTriggerIds:
                                    minItems: 1
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                required:
                                  - sourceTriggerIds
                                additionalProperties: false
                              triggerId:
                                type: string
                                format: uuid
                                pattern: >-
                                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                              createdAt:
                                type: string
                              updatedAt:
                                type: string
                            required:
                              - id
                              - slug
                              - kind
                              - enabled
                              - config
                              - triggerId
                              - createdAt
                              - updatedAt
                            additionalProperties: false
                    skill:
                      anyOf:
                        - type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                              pattern: >-
                                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                            key:
                              type: string
                            revision:
                              type: integer
                              exclusiveMinimum: 0
                              maximum: 9007199254740991
                          required:
                            - id
                            - key
                            - revision
                          additionalProperties: false
                        - type: 'null'
                    contextReviewRequired:
                      type: boolean
                    createdAt:
                      type: string
                    updatedAt:
                      type: string
                  required:
                    - id
                    - name
                    - enabled
                    - requiresVm
                    - prompt
                    - runNameTemplate
                    - model
                    - executionConfig
                    - runScopes
                    - executionConfigId
                    - agentKind
                    - concurrencyLimit
                    - runningCount
                    - currentRuns
                    - maxConcurrency
                    - lastRunState
                    - events
                    - createdAt
                    - updatedAt
                  additionalProperties: false
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '409':
          $ref: '#/components/responses/Error409'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '503':
          $ref: '#/components/responses/Error503'
      security:
        - bearerAuth: []
        - vendorRunIdentity: []
          runIdentityHeader: []
        - cookieAuth: []
components:
  responses:
    Error400:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error401:
      description: Invalid or revoked credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error403:
      description: Missing scope or required owner session
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error409:
      description: Operation conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error429:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error500:
      description: Internal error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error503:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
    vendorRunIdentity:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Fresh vendor-signed exe.dev WIF or Fly Machine OIDC token matching the
        provisioned active run. Must be combined with X-Factorize-Run-Id; a
        vendor token alone grants no access.
    runIdentityHeader:
      type: apiKey
      in: header
      name: X-Factorize-Run-Id
      description: >-
        Provisioned run UUID. Used only to locate the immutable vendor/VM
        binding; this header is not a credential. Scopes and tenant come from
        the server-side run snapshot.
    cookieAuth:
      type: apiKey
      in: cookie
      name: factorize_session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.