> ## 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.

# Create a saved filter

> Create a saved AI Finder filter for later reuse. Filters are provider-aware and can be loaded directly into preview creation via `savedFilterId`.

    > **Required scope:** `ACTIONS_WRITE`
    >
    > **Rate limit:** 30 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json post /v1/saved-filters
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/saved-filters:
    post:
      tags:
        - Saved Filters
      summary: Create a saved filter
      description: >-
        Create a saved AI Finder filter for later reuse. Filters are
        provider-aware and can be loaded directly into preview creation via
        `savedFilterId`.

            > **Required scope:** `ACTIONS_WRITE`
            >
            > **Rate limit:** 30 requests per minute
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  description: Name for the saved filter.
                provider:
                  type: string
                  enum:
                    - LINKEDIN
                    - CRM_CONTACTS
                    - CRM_COMPANIES
                    - STORELEADS
                    - CRUNCHBASE_COMPANIES
                    - CRUNCHBASE_CONTACTS
                    - CRUNCHBASE_INVESTORS
                    - THEIRSTACK_TECHNOLOGY
                    - THEIRSTACK_JOBS
                    - GOOGLE_MAPS
                  default: LINKEDIN
                  description: >-
                    Which AI Finder provider this saved filter belongs to.
                    Defaults to `LINKEDIN` for backward compatibility.
                filters:
                  type: object
                  additionalProperties: {}
                  description: >-
                    Primary provider-specific search filters configuration to
                    save. For `LINKEDIN`, send the field-keyed map directly
                    (e.g. `{"REGION": [...], "CURRENT_TITLE": [...]}`) — do NOT
                    wrap it in a top-level `filtersByType` key. A single
                    `filtersByType` wrapper is auto-unwrapped for backward
                    compatibility, but the unwrapped shape is required. For
                    `CRM_CONTACTS` and `CRM_COMPANIES`, send the exact same
                    `{"include": {...}, "exclude": {...}}` shape used by
                    `search_contacts_with_advanced_filters` /
                    `search_companies_with_advanced_filters` (e.g. `{"include":
                    {"icpScore": ["80", "100"]}, "exclude": {"companyGroup":
                    [12]}}`); CRM saved filters round-trip through that same
                    advanced-search filter DSL.
                keywords:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  description: Optional keywords associated with this saved filter.
                searchFallbackFilters:
                  type: array
                  items:
                    type: object
                    properties:
                      filters:
                        type: object
                        additionalProperties: {}
                        description: LinkedIn search filters configuration for this step.
                      keywords:
                        type: array
                        items:
                          type: string
                          minLength: 1
                        description: Keywords associated with this fallback search step.
                    required:
                      - filters
                      - keywords
                  description: >-
                    Optional ordered fallback searches to try after the primary
                    filter.
                type:
                  type: string
                  enum:
                    - LEAD
                    - COMPANY
                  description: Saved filter type (LEAD or COMPANY).
                isShared:
                  type: boolean
                  default: false
                  description: Whether the saved filter is shared with the team.
              required:
                - name
                - filters
                - type
      responses:
        '201':
          description: Saved filter created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: number
                        description: Created saved filter ID.
                    required:
                      - id
                required:
                  - status
                  - message
                  - data
        '400':
          description: Bad request - validation error
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````