INinstantly
SuperSearchEnrichment

Update a saved search

Changed on

Rename a saved search and/or replace its filters.

Requires one of the following scopes: supersearch_enrichments:update, supersearch_enrichments:all, all:update, all:all

patch/api/v2/supersearch-enrichment/saved-searches/{id}

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/supersearch-enrichment/saved-searches/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:01a19e6f-83c1-7c8c-bc61-6d280591f885

Saved search ID

Request body

namestring

New display name

Example request

{
  "name": "US fintech VPs (Q4)",
  "search_filters": {
    "company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
    "locations": [
      {
        "place_id": "ChIJN1t_t3uEmsRUso9K6W47H4",
        "label": "San Francisco, CA, USA"
      }
    ],
    "department": [
      "Engineering"
    ],
    "level": [
      "Entry level"
    ],
    "employeeCount": [
      "0 - 25"
    ],
    "revenue": [
      "$1 - 10M"
    ],
    "news": [
      "launches"
    ],
    "jobListing": [
      "Software Engineer"
    ],
    "jobListingFilter": [
      "Software Engineer"
    ],
    "title": {
      "include": [
        "CEO"
      ],
      "exclude": [
        "VP"
      ],
      "includeMode": "CONTAINS",
      "excludeMode": "CONTAINS"
    },
    "name": [
      "John Doe"
    ],
    "company_name": {
      "include": [
        "Google"
      ],
      "exclude": [
        "Amazon"
      ]
    },
    "businessType": {
      "include": [
        "agency"
      ],
      "exclude": [
        "staffing_recruiting"
      ]
    },
    "customerType": {
      "include": [
        "b2b"
      ],
      "exclude": [
        "b2c"
      ]
    },
    "look_alike": "google.com",
    "lookAlike": "google.com",
    "lookAlikeMode": "targeted",
    "technologies": [
      "Salesforce"
    ],
    "fundingType": [
      "seed"
    ],
    "locationMode": "contact",
    "keyword_filter": {
      "exclude": "sales",
      "include": "marketing",
      "include_mode": "ANY"
    },
    "industry": {
      "exclude": [
        "Agriculture & Mining"
      ],
      "include": [
        "Agriculture & Mining"
      ]
    },
    "subIndustry": {
      "exclude": [
        "Animation"
      ],
      "include": [
        "Animation"
      ]
    },
    "domains": [
      "google.com"
    ],
    "website_visitors": true,
    "funding_type": [
      "angel"
    ],
    "signals": [
      "job_change"
    ],
    "skip_owned_leads": true,
    "show_one_lead_per_company": true,
    "location_mode": "contact"
  }
}

Response

Default Response

idstring uuid required

Saved search ID

namestring required

Display name

organization_idstring uuid required

Workspace that owns the saved search

timestamp_createdstring date-time

When the search was saved

Example response

{
  "id": "01a19e6f-83c1-7c8c-bc61-6d280591f885",
  "name": "US fintech VPs",
  "search_filters": {
    "title": {
      "include": [
        "VP Sales"
      ],
      "exclude": []
    },
    "locations": {
      "include": [
        {
          "country": "United States"
        }
      ],
      "exclude": []
    }
  },
  "organization_id": "01a19e6f-83c1-7c8c-bc61-6d280591f885",
  "timestamp_created": "2026-11-02T22:44:30.785Z"
}

Changes