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

# Get workflow run-now options

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Tells you what [Run a workflow now](/api-reference/run-a-workflow-now) needs for this workflow.

When `manual_run_config.requires_previous_run` is `false` the workflow runs with an empty payload and you can call run-now with an empty body. When it is `true` the trigger's payload refers to real data in the app, so a manual run has to replay a previous run's payload and you pass one of the `recent_runs` IDs as `replay_from_run_id`.

Every run listed in `recent_runs` is known to be replayable, so a run-now using one should not be refused. The list holds at most 20 runs and is empty when the trigger needs no payload.

This endpoint is limited to 30 requests per minute.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/workflows/{workflow_id}/run-now-info
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/workflows/{workflow_id}/run-now-info:
    get:
      summary: Get workflow run-now options
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Tells you what [Run a workflow now](/api-reference/run-a-workflow-now)
        needs for this workflow.


        When `manual_run_config.requires_previous_run` is `false` the workflow
        runs with an empty payload and you can call run-now with an empty body.
        When it is `true` the trigger's payload refers to real data in the app,
        so a manual run has to replay a previous run's payload and you pass one
        of the `recent_runs` IDs as `replay_from_run_id`.


        Every run listed in `recent_runs` is known to be replayable, so a
        run-now using one should not be refused. The list holds at most 20 runs
        and is empty when the trigger needs no payload.


        This endpoint is limited to 30 requests per minute.
      operationId: >-
        get_run_now_info_api_apps__app_id__workflows__workflow_id__run_now_info_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose workflows you want to work with.
            title: App Id
          description: ID of the app whose workflows you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
        - name: workflow_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the workflow, as returned in `id` by [List
              workflows](/api-reference/list-workflows).
            title: Workflow Id
          description: >-
            ID of the workflow, as returned in `id` by [List
            workflows](/api-reference/list-workflows).
          example: 68b1c0d4e7b91d003c45a1f2
      responses:
        '200':
          description: What a manual run needs, and which runs can be replayed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunNowInfoResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, the app does not exist, the app
            still runs the older automations engine instead of workflows, or you
            used a workspace API key. A missing app and an app you cannot reach
            are deliberately the same answer.
        '404':
          description: There is no workflow with this ID on this app.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RunNowInfoResponse:
      properties:
        manual_run_config:
          $ref: '#/components/schemas/TriggerManualRunConfig'
          description: What a manual run of this workflow needs.
        recent_runs:
          items:
            $ref: '#/components/schemas/RunItem'
          type: array
          title: Recent Runs
          description: >-
            Runs whose payload you can replay, newest first, at most 20. Empty
            when the trigger needs no payload.
          example: []
      type: object
      required:
        - manual_run_config
      title: RunNowInfoResponse
      description: Data for the builder's "Run now" dialog.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TriggerManualRunConfig:
      properties:
        requires_previous_run:
          type: boolean
          title: Requires Previous Run
          default: true
      type: object
      title: TriggerManualRunConfig
      description: |-
        Per-trigger behavior of the builder's manual "Run now" experience.

        ``requires_previous_run``: the trigger payload references real in-app
        state (entity records, agent conversations, connector events) that a
        synthetic payload can't satisfy — a manual run must replay the payload
        of a previous run. Triggers that run without a payload (e.g. scheduled)
        set this to False.
    RunItem:
      properties:
        run_id:
          type: string
          title: Run Id
          description: ID of the run.
          example: 0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77
        workflow_id:
          type: string
          title: Workflow Id
          description: ID of the workflow that ran.
          example: 68b1c0d4e7b91d003c45a1f2
        workflow_name:
          type: string
          title: Workflow Name
          description: Name of that workflow at the time of the run.
          default: ''
          example: Email me new signups
        trigger_type:
          type: string
          title: Trigger Type
          description: What started the run, for example `scheduled` or `entity_created`.
          default: ''
          example: scheduled
        status:
          type: string
          title: Status
          description: >-
            How the run is going: `running`, `completed`, `failed`, or
            `cancelled`.
          example: completed
        started_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Started At
          description: When the run started, as an ISO 8601 timestamp.
          example: '2026-08-25T09:12:44Z'
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
          description: When the run finished. `null` while it is still running.
          example: '2026-08-25T09:12:46Z'
        duration_ms:
          type: integer
          title: Duration Ms
          description: >-
            How long the run took, in milliseconds. `0` while it is still
            running.
          default: 0
          example: 1840
        steps_count:
          type: integer
          title: Steps Count
          description: Steps the run executed.
          default: 0
          example: 3
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
          description: Why the run failed. `null` when it did not fail.
          example: The email step failed because the recipient address was missing.
        is_test_run:
          type: boolean
          title: Is Test Run
          description: >-
            `true` when the run was started by hand through Run a workflow now,
            rather than by its trigger.
          default: false
          example: false
        credits_consumed:
          type: number
          title: Credits Consumed
          description: Credits the run used.
          default: 0
          example: 0.5
        status_reason:
          type: string
          title: Status Reason
          description: >-
            Why the run failed or was cancelled. Empty on runs that finished
            successfully.
          default: ''
          example: ''
      type: object
      required:
        - run_id
        - workflow_id
        - status
      title: RunItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````