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

# Get workflow import inputs

> Convert an AI Finder preview into the exact blockId and inputs for a workflow import source. First call preview_an_ai_finder_search with the target audience and provider, or reuse its latest previewId. Pass the number to import on each workflow run as maxCount. LinkedIn people/company searches return a generated Sales Navigator URL: the user does not need to provide one. Also supports Google Maps, fundraising data, StoreLeads, TheirStack and supported CRM searches. Use the returned blockId with empty node inputs and pass { nodeId, ...source } in importSources to validate_workflow, create_workflow or update_workflow_draft. Those endpoints materialize the exact source values server-side; do not copy or reconstruct long encoded URLs. This only prepares configuration; it does not import contacts/companies, create a list, or run/publish a workflow. Expired previews must be regenerated from the audience description. Unsupported sources return an explicit error.

    > **Required scope:** `WORKFLOWS_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/workflows/import-inputs
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths:
  /v1/workflows/import-inputs:
    get:
      tags:
        - Workflows
      summary: Get workflow import inputs
      description: >-
        Convert an AI Finder preview into the exact blockId and inputs for a
        workflow import source. First call preview_an_ai_finder_search with the
        target audience and provider, or reuse its latest previewId. Pass the
        number to import on each workflow run as maxCount. LinkedIn
        people/company searches return a generated Sales Navigator URL: the user
        does not need to provide one. Also supports Google Maps, fundraising
        data, StoreLeads, TheirStack and supported CRM searches. Use the
        returned blockId with empty node inputs and pass { nodeId, ...source }
        in importSources to validate_workflow, create_workflow or
        update_workflow_draft. Those endpoints materialize the exact source
        values server-side; do not copy or reconstruct long encoded URLs. This
        only prepares configuration; it does not import contacts/companies,
        create a list, or run/publish a workflow. Expired previews must be
        regenerated from the audience description. Unsupported sources return an
        explicit error.

            > **Required scope:** `WORKFLOWS_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 200
            description: Latest previewId from preview_an_ai_finder_search.
          required: true
          description: Latest previewId from preview_an_ai_finder_search.
          name: previewId
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 10000
            description: Maximum records to import per run.
          required: true
          description: Maximum records to import per run.
          name: maxCount
          in: query
      responses:
        '200':
          description: Workflow import configuration resolved
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      blockId:
                        type: string
                      inputs:
                        type: object
                        additionalProperties: {}
                      source:
                        type: object
                        properties:
                          previewId:
                            type: string
                            minLength: 1
                            maxLength: 200
                            description: >-
                              Latest AI Finder previewId for the source
                              audience.
                          maxCount:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 10000
                            description: Maximum records to import per workflow run.
                        required:
                          - previewId
                          - maxCount
                        additionalProperties: false
                      warnings:
                        type: array
                        items:
                          type: string
                    required:
                      - blockId
                      - inputs
                      - source
                required:
                  - status
                  - message
                  - data
        '400':
          description: Invalid previewId or maxCount
        '403':
          description: >-
            Advanced workflows are not enabled for this workspace. Ask your
            workspace admin to enable the feature.
        '404':
          description: Preview not found, expired, or unavailable to the caller
        '422':
          description: Preview cannot be represented by a supported workflow import block
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````