> ## Documentation Index > Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt > Use this file to discover all available pages before exploring further. # Run Workflow > Start a workflow run and return a job ID for tracking. Supports per-run spec overrides via `specs_override` and webhook input via `webhook_payload`. API-triggered `read_csv` workflows must provide `specs_override.resource_handle_id` from `/storage/csv/upload`. ## OpenAPI ````yaml https://api.sixtyfour.ai/openapi.json post /workflows/run openapi: 3.1.0 info: title: Sixtyfour API description: >- Intelligence API for People and Entities. Deploy AI agents that investigate, resolve identities, map relationships, and surface risk signals contact: name: Sixtyfour url: https://sixtyfour.ai/ email: support@sixtyfour.ai license: name: Proprietary version: 1.0.0 servers: - url: https://api.sixtyfour.ai description: Production security: [] tags: - name: Enrichment description: Find and enrich emails, phones, and LinkedIn for people and companies. - name: org-chart description: Discover people inside a company and build org charts. - name: Search description: Run deep and filter searches over Sixtyfour's data. - name: Workflow description: Create, run, and manage enrichment workflows. - name: Workflow Schedules description: Create and manage recurring schedules for workflows. - name: Account description: Manage and inspect your account and credit balance. - name: Intelligence description: Verify identity attributes such as age using high-tier OSINT research. paths: /workflows/run: post: tags: - Workflow summary: Run Workflow description: >- Start a workflow run and return a job ID for tracking. Supports per-run spec overrides via `specs_override` and webhook input via `webhook_payload`. API-triggered `read_csv` workflows must provide `specs_override.resource_handle_id` from `/storage/csv/upload`. operationId: run_workflow_workflows_run_post parameters: - name: workflow_id in: query required: true schema: type: string description: Workflow ID to run title: Workflow Id description: Workflow ID to run - name: save_json in: query required: false schema: type: boolean description: Also save results as JSON default: false title: Save Json description: Also save results as JSON - name: result_formats in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- Result formats to save. Repeat the parameter for multiple values, e.g. result_formats=csv&result_formats=ndjson. title: Result Formats description: >- Result formats to save. Repeat the parameter for multiple values, e.g. result_formats=csv&result_formats=ndjson. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key requestBody: content: application/json: schema: $ref: '#/components/schemas/Body_run_workflow_workflows_run_post' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/WorkflowRunStartedResponse' '400': description: Request was rejected by the route's validation rules. content: application/json: schema: type: object properties: detail: type: string example: detail: Invalid request body '401': description: Missing or invalid API key. content: application/json: schema: type: object properties: detail: type: string example: detail: Invalid API key '403': description: Caller does not have access to this workflow. content: application/json: schema: type: object properties: detail: type: string example: detail: Access denied '404': description: Workflow, run, or job not found. content: application/json: schema: type: object properties: detail: type: string example: detail: Workflow not found '409': description: Workflow with the supplied ID already exists. content: application/json: schema: type: object properties: detail: type: string example: detail: >- Workflow with ID 0123abcd-1234-5678-9abc-def012345678 already exists. Use update endpoint to modify existing workflows. '422': description: Request body failed validation. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Unexpected server error. Retry with backoff. content: application/json: schema: type: object properties: detail: type: string example: detail: Internal server error components: schemas: Body_run_workflow_workflows_run_post: properties: specs_override: anyOf: - additionalProperties: true type: object - type: 'null' title: Specs Override description: Optional specs to override first block specs webhook_payload: anyOf: - items: additionalProperties: true type: object type: array - additionalProperties: true type: object - type: 'null' title: Webhook Payload description: For API key auth only - can be a list or dict type: object title: Body_run_workflow_workflows_run_post WorkflowRunStartedResponse: properties: status: type: string title: Status description: Run status, typically 'queued'. workflow_id: type: string title: Workflow Id description: Workflow identifier. job_id: type: string title: Job Id description: Job (run) identifier. cache_config: anyOf: - additionalProperties: true type: object - type: 'null' title: Cache Config description: Cache configuration; only set by the custom-cache endpoint. already_started: anyOf: - type: boolean - type: 'null' title: Already Started description: True when the request was deduplicated via Idempotency-Key header. type: object required: - status - workflow_id - job_id title: WorkflowRunStartedResponse description: Response when a workflow run is started. HTTPValidationError: title: HTTPValidationError type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' example: detail: - loc: - body - target_company - domain msg: Field required type: missing input: null ctx: {} ValidationError: title: ValidationError type: object required: - loc - msg - type properties: loc: type: array items: oneOf: - type: string - type: integer description: Path to the field that failed validation. example: - body - target_company - domain msg: type: string description: Human-readable error message. example: Field required type: type: string description: Error code (e.g. 'missing', 'value_error'). example: missing input: description: The offending input value (any type, may be null). nullable: true example: null ctx: type: object description: Optional error context. additionalProperties: true example: {} ````