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

# Trigger a workflow

> Start a standalone workflow that uses a webhook trigger. The workflow must be enabled and published.

The JSON body is passed into the workflow as input. It does not have to match the workflow's Expected input: extra fields are kept, and missing fields are empty in the run. The body must be a JSON object. Arrays and other non-object values are treated as an empty object.

A request to an enabled workflow that has never been published returns 202, but the run will not complete because there is no published version to run.



## OpenAPI

````yaml post /api/workflows/{workflowId}/trigger
openapi: 3.1.0
info:
  title: Strada Voice API
  version: 1.0.0
  description: API for managing voice calls
servers:
  - url: https://api.getstrada.com
    description: Production server
security: []
paths:
  /api/workflows/{workflowId}/trigger:
    post:
      tags:
        - Workflows
      summary: Trigger a workflow
      description: >-
        Start a standalone workflow that uses a webhook trigger. The workflow
        must be enabled and published.


        The JSON body is passed into the workflow as input. It does not have to
        match the workflow's Expected input: extra fields are kept, and missing
        fields are empty in the run. The body must be a JSON object. Arrays and
        other non-object values are treated as an empty object.


        A request to an enabled workflow that has never been published returns
        202, but the run will not complete because there is no published version
        to run.
      parameters:
        - name: workflowId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            ID of the standalone workflow to trigger, from the Workflow ID
            column
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerWorkflowRequest'
      responses:
        '202':
          description: Workflow accepted for execution
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerWorkflowResponse'
        '400':
          description: Bad request - workflow id is missing
        '401':
          description: Unauthorized - invalid or missing API key
        '403':
          description: Forbidden - the workflow is disabled
        '404':
          description: >-
            Not found - the workflow does not exist or has no webhook trigger
            configured
        '429':
          description: Too many requests - rate limit exceeded
        '500':
          description: Failed to trigger workflow
      security:
        - bearerAuth: []
components:
  schemas:
    TriggerWorkflowRequest:
      type: object
      additionalProperties: true
      description: >-
        Input passed into the workflow. Must be a JSON object. The fields are
        yours to define and should match the workflow's Expected input. Extra
        fields are kept, and missing fields are empty in the run.
      example:
        policyNumber: HO-1048291
        claimId: CLM-20391
    TriggerWorkflowResponse:
      type: object
      required:
        - workflowTriggeredId
      properties:
        workflowTriggeredId:
          type: string
          format: uuid
          description: Identifier for this trigger invocation
          example: b4f7c8e2-1a3d-4e5f-9c6b-7d8e9f0a1b2c
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Key authentication

````