> ## Documentation Index > Fetch the complete documentation index at: https://docs.connie.ai/llms.txt > Use this file to discover all available pages before exploring further. # Run a workflow on list rows > Runs a workflow whose trigger is a list (**Records** source) on its rows: all of them, the first 10, the first one, or the rows you pick. Rows that are already running are skipped and returned in `runningRowIds`; if every row is already running you get 409 `ROWS_ALREADY_RUNNING`. The `runOnlyOnEmptyCells` and `keepRunningOnNewRows` choices are saved on the trigger. Needs edit access and enough credits. ## OpenAPI ````yaml /openapi/automations.yaml post /workflows/{workflowId}/run/source-table openapi: 3.1.0 info: title: Connie Automations API version: 1.0.0 description: > Endpoints the Connie web app uses for automations. They authenticate with your signed-in browser session — see https://docs.connie.ai/api-reference/authentication. These are the app's own endpoints and can change when the app changes. servers: - url: https://connie.ai/api security: - sessionCookie: [] tags: - name: Workflows description: List, create, read, update and delete workflows. - name: Runs description: >- Start, retry and stop workflow runs, switch a workflow Live, and read run counts. - name: Triggers description: A workflow's triggers and its schedule settings. - name: Templates description: The template gallery and copying a template into a workspace. - name: Agents description: Agents on the Agents page. paths: /workflows/{workflowId}/run/source-table: post: tags: - Runs summary: Run a workflow on list rows description: > Runs a workflow whose trigger is a list (**Records** source) on its rows: all of them, the first 10, the first one, or the rows you pick. Rows that are already running are skipped and returned in `runningRowIds`; if every row is already running you get 409 `ROWS_ALREADY_RUNNING`. The `runOnlyOnEmptyCells` and `keepRunningOnNewRows` choices are saved on the trigger. Needs edit access and enough credits. operationId: runWorkflowOnRows parameters: - $ref: '#/components/parameters/workflowId' requestBody: required: true content: application/json: schema: type: object properties: selection: type: string enum: - all - first_10 - first_only - selected_rows default: all rowIds: type: array maxItems: 500 items: type: string format: uuid description: Required when `selection` is `selected_rows`. At most 500. runOnlyOnEmptyCells: type: boolean default: true description: Only fill cells that are still empty. keepRunningOnNewRows: type: boolean default: true description: Keep running on rows added to the list later. responses: '200': description: Runs started. content: application/json: schema: $ref: '#/components/schemas/RowRunResult' '400': description: >- The workflow has no list trigger, `rowIds` is missing for `selected_rows`, or more than 500 rows were picked. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/InsufficientCredits' '403': $ref: '#/components/responses/Forbidden' '404': description: The workflow wasn't found, or there are no rows to run. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- Every selected row is already running, or every selected row's source record was deleted. content: application/json: schema: $ref: '#/components/schemas/RowRunResult' components: parameters: workflowId: name: workflowId in: path required: true description: >- The workflow's id, as in `https://connie.ai//workflows/`. schema: type: string format: uuid schemas: RowRunResult: type: object properties: success: type: boolean description: True when at least one row started. started: type: integer failed: type: integer skippedRunning: type: integer description: Rows skipped because they were already running. runningRowIds: type: array items: type: string skippedDeletedSource: type: integer description: Rows skipped because their source record was deleted. code: type: string description: '`ROWS_ALREADY_RUNNING` on a 409 where every row was already running.' message: type: string description: Which rows were skipped and that they must be stopped first. error: type: string Error: type: object properties: error: type: string description: Human-readable message. code: type: string description: Machine-readable code, when there is one. details: description: Extra detail, for example the invalid fields. required: - error responses: Unauthorized: description: >- Not signed in (`UNAUTHORIZED`), or the session cookie has expired (`SESSION_EXPIRED`). content: application/json: schema: $ref: '#/components/schemas/Error' InsufficientCredits: description: Not enough credits to run (`INSUFFICIENT_CREDITS`). content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: >- You aren't a member of the workspace, or don't have the access this needs. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: sessionCookie: type: apiKey in: header name: Cookie description: >- The full Cookie header copied from a signed-in connie.ai browser request. See the Authentication page. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.