curl --request PATCH \
  --url https://intentleads.si/api/v1/lanes/{code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "min_strength": "high",
  "company_list_mode": "replace"
}
'

{
  "code": "L1",
  "name": "Medical device distributors",
  "priority": 1,
  "min_strength": "medium",
  "keywords_live": 8,
  "keywords_pending": 2,
  "researching_latest_day": {
    "all": 1840,
    "medium_plus": 620,
    "high": 95,
    "as_of": "2026-10-13",
    "deliverable": false,
    "note": "Quick topic signal from a separate preview index for one day, before any filter. Not people you could receive; use after_filters for that."
  },
  "researching_14d": {
    "all": 21450,
    "medium_plus": 7310,
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    }
  },
  "after_filters": {
    "all": 1265,
    "medium_plus": 412,
    "at_lane_strength": 412,
    "filters_used": "industries",
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    },
    "checked_at": "2026-10-14T06:12:41.528311+00:00"
  },
  "company_list_mode": "off",
  "audience": "Owners and sales leaders at US medical device distributors with 20 to 300 staff",
  "filters": {
    "countries": [
      "United States"
    ],
    "headquarters_only": true,
    "employees": {
      "min": 20,
      "max": 300
    },
    "industries": [
      "medical equipment manufacturing",
      "wholesale"
    ],
    "suggested_industries_not_applied": [],
    "seniority": [
      "cxo",
      "vp",
      "director"
    ],
    "titles_include": [],
    "titles_exclude": [
      "intern",
      "assistant"
    ],
    "industries_exclude": [],
    "exclude_companies": [
      "staffing firms"
    ],
    "exclusions": {
      "left_out_by_filter": [],
      "screened_before_export": [
        "staffing firms"
      ],
      "note": "industries_exclude is applied wherever the lane's industry list isn't (the company-list path, or a lane with no industries). Screened items have no matching industry tag, so DBEE checks them before export."
    },
    "negative_topics": [
      "job openings"
    ]
  },
  "keywords": [
    {
      "position": 1,
      "keyword": "selling to group purchasing organizations",
      "status": "live",
      "live_since": "2026-09-22",
      "researching_latest_day": {
        "all": 310,
        "medium_plus": 102,
        "high": 14,
        "as_of": "2026-10-13",
        "deliverable": false
      },
      "after_filters": {
        "all": 96,
        "window_end": "2026-10-10",
        "note": "People on this keyword who pass the lane's US, size, industry, seniority and title filters over 14 days, any strength. Sized weekly."
      }
    },
    {
      "position": 2,
      "keyword": "hospital supply chain contracts",
      "status": "pending_approval",
      "live_since": null,
      "researching_latest_day": {
        "all": null,
        "medium_plus": null,
        "high": null,
        "as_of": null,
        "deliverable": false
      },
      "after_filters": null
    }
  ],
  "funnel": {
    "checked_at": "2026-10-14T06:12:41.528311+00:00",
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    },
    "unit": "people",
    "note": "Finals are checked daily, other steps weekly; window_end is the last data day of the 14-day window behind each number.",
    "filters_used": "industries",
    "industry_path": {
      "intent": {
        "all": {
          "people": 21450,
          "window_end": "2026-10-10"
        },
        "medium_plus": {
          "people": 7310,
          "window_end": "2026-10-10"
        }
      },
      "us": {
        "all": {
          "people": 14200,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 4905,
          "window_end": "2026-10-10"
        }
      },
      "size": {
        "all": {
          "people": 6020,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 2080,
          "window_end": "2026-10-10"
        }
      },
      "industry": {
        "all": {
          "people": 2410,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 815,
          "window_end": "2026-10-10"
        }
      },
      "seniority": {
        "all": {
          "people": 1530,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 498,
          "window_end": "2026-10-10"
        }
      },
      "titles": {
        "all": {
          "people": 1265,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 412,
          "window_end": "2026-10-13"
        }
      }
    },
    "company_list_path": null,
    "both": null
  }
}

Update a lane

Changes a lane’s settings and filters. Fields you leave out keep their value; send null for employees to allow any size, or an empty list to clear a list filter. Returns the lane as Get a lane does.

Settings: min_strength (low = any strength, medium = medium and high, high = high only) and company_list_mode (narrow = lane industries and your company list; replace = your company list instead of industries; off = ignore the list).

Filters: name, audience, us_only, employees, industries, industries_exclude, seniority, titles_include, titles_exclude, topics_to_leave_out, exclude_companies.

Good to know

Counts in the response are from the last check, before your change. They update at the lane’s next check (daily, or queue one with POST /api/v1/lanes/{code}/checks).
Changing any filter re-validates the lane’s whole filter set, so its name (2 to 80 characters) and audience (10+ characters) must still be valid.
Keywords aren’t changed here; use the Keywords endpoints.
enabled and max_per_day were removed and return removed_field.

Free. This doesn’t use any contacts from your plan.

PATCH

api

lanes

{code}

curl --request PATCH \
  --url https://intentleads.si/api/v1/lanes/{code} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "min_strength": "high",
  "company_list_mode": "replace"
}
'

{
  "code": "L1",
  "name": "Medical device distributors",
  "priority": 1,
  "min_strength": "medium",
  "keywords_live": 8,
  "keywords_pending": 2,
  "researching_latest_day": {
    "all": 1840,
    "medium_plus": 620,
    "high": 95,
    "as_of": "2026-10-13",
    "deliverable": false,
    "note": "Quick topic signal from a separate preview index for one day, before any filter. Not people you could receive; use after_filters for that."
  },
  "researching_14d": {
    "all": 21450,
    "medium_plus": 7310,
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    }
  },
  "after_filters": {
    "all": 1265,
    "medium_plus": 412,
    "at_lane_strength": 412,
    "filters_used": "industries",
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    },
    "checked_at": "2026-10-14T06:12:41.528311+00:00"
  },
  "company_list_mode": "off",
  "audience": "Owners and sales leaders at US medical device distributors with 20 to 300 staff",
  "filters": {
    "countries": [
      "United States"
    ],
    "headquarters_only": true,
    "employees": {
      "min": 20,
      "max": 300
    },
    "industries": [
      "medical equipment manufacturing",
      "wholesale"
    ],
    "suggested_industries_not_applied": [],
    "seniority": [
      "cxo",
      "vp",
      "director"
    ],
    "titles_include": [],
    "titles_exclude": [
      "intern",
      "assistant"
    ],
    "industries_exclude": [],
    "exclude_companies": [
      "staffing firms"
    ],
    "exclusions": {
      "left_out_by_filter": [],
      "screened_before_export": [
        "staffing firms"
      ],
      "note": "industries_exclude is applied wherever the lane's industry list isn't (the company-list path, or a lane with no industries). Screened items have no matching industry tag, so DBEE checks them before export."
    },
    "negative_topics": [
      "job openings"
    ]
  },
  "keywords": [
    {
      "position": 1,
      "keyword": "selling to group purchasing organizations",
      "status": "live",
      "live_since": "2026-09-22",
      "researching_latest_day": {
        "all": 310,
        "medium_plus": 102,
        "high": 14,
        "as_of": "2026-10-13",
        "deliverable": false
      },
      "after_filters": {
        "all": 96,
        "window_end": "2026-10-10",
        "note": "People on this keyword who pass the lane's US, size, industry, seniority and title filters over 14 days, any strength. Sized weekly."
      }
    },
    {
      "position": 2,
      "keyword": "hospital supply chain contracts",
      "status": "pending_approval",
      "live_since": null,
      "researching_latest_day": {
        "all": null,
        "medium_plus": null,
        "high": null,
        "as_of": null,
        "deliverable": false
      },
      "after_filters": null
    }
  ],
  "funnel": {
    "checked_at": "2026-10-14T06:12:41.528311+00:00",
    "data_window": {
      "start": "2026-09-30",
      "end": "2026-10-13"
    },
    "unit": "people",
    "note": "Finals are checked daily, other steps weekly; window_end is the last data day of the 14-day window behind each number.",
    "filters_used": "industries",
    "industry_path": {
      "intent": {
        "all": {
          "people": 21450,
          "window_end": "2026-10-10"
        },
        "medium_plus": {
          "people": 7310,
          "window_end": "2026-10-10"
        }
      },
      "us": {
        "all": {
          "people": 14200,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 4905,
          "window_end": "2026-10-10"
        }
      },
      "size": {
        "all": {
          "people": 6020,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 2080,
          "window_end": "2026-10-10"
        }
      },
      "industry": {
        "all": {
          "people": 2410,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 815,
          "window_end": "2026-10-10"
        }
      },
      "seniority": {
        "all": {
          "people": 1530,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 498,
          "window_end": "2026-10-10"
        }
      },
      "titles": {
        "all": {
          "people": 1265,
          "window_end": "2026-10-13"
        },
        "medium_plus": {
          "people": 412,
          "window_end": "2026-10-13"
        }
      }
    },
    "company_list_path": null,
    "both": null
  }
}

Authorizations

Authorization

string

header

required

An Intent Leads API key, e.g. il_live_ followed by 32 letters and digits. Create one on the API and CLI page of the dashboard.

Path Parameters

code

string

required

Lane code, e.g. L1. Case-insensitive.

Body

application/json

Send only what you want to change.

min_strength

enum<string>

Minimum intent strength: low = any, medium = medium and high, high = high only.

Available options:

low,

medium,

high

company_list_mode

enum<string>

narrow, replace or off.

Available options:

narrow,

replace,

off

name

string

2 to 80 characters.

Required string length: 2 - 80

audience

string

Who you sell to in this lane: at least a short sentence (10+ characters, cut at 400).

Minimum string length: 10

us_only

boolean

Only people at companies headquartered in the US. Defaults to true on create.

employees

object | null

Company size range, both ends from 1 to 100,000 and at most 5,000 apart, e.g. {"min": 20, "max": 300}. Send both or neither. null means any size.

Show child attributes

industries

string[]

Industry values from GET /api/v1/catalog (case-insensitive). Unknown values are an error. Up to 60; extra entries are dropped.

industries_exclude

string[]

Industries to leave out where the industry list isn't applied (the company-list path, or a lane with no industries). Catalog values. Up to 80; extra entries are dropped.

seniority

enum<string>[]

Seniority levels. cxo is C-suite and owners.

Available options:

cxo,

vp,

director,

manager,

staff

titles_include

string[]

Job title must contain one of these. Stored lowercase. Up to 60; extra entries are dropped.

titles_exclude

string[]

Job title must not contain any of these. Stored lowercase. Up to 80; extra entries are dropped.

topics_to_leave_out

string[]

Topics to leave out of the keyword topics, e.g. job openings. Up to 40; extra entries are dropped.

exclude_companies

string[]

Kinds of companies to leave out, e.g. staffing firms. Up to 20; extra entries are dropped.

Response

The updated lane.

code

string

required

Lane code, e.g. L1.

Example:

"L1"

name

string

required

priority

integer

required

Order in which lanes are listed and filled (lower first).

min_strength

enum<string>

required

Intent strength. As a minimum: low = any strength, medium = medium and high, high = high only.

Available options:

low,

medium,

high

company_list_mode

enum<string>

required

How the lane uses your company list: narrow = lane industries and your list; replace = your list instead of industries; off = ignore the list.

Available options:

narrow,

replace,

off

keywords_live

integer

required

Keywords approved and in use.

keywords_pending

integer

required

Keywords waiting for approval.

researching_latest_day

object

required

Quick one-day topic signal, before any filter. Not people you could export.

Show child attributes

researching_14d

object | null

required

People researching the lane's keywords over the data window, before any filter, from the latest check. Null until the first check finishes.

Show child attributes

after_filters

object | null

required

People who pass every filter over the data window, from the latest check. Everyone already exported to you this billing period was left out when the check ran. This is what an export draws from. Null until the first check finishes.

Show child attributes

audience

string | null

required

Who you sell to in this lane.

filters

object

required

Show child attributes

keywords

object[]

required

Every keyword except removed ones, in order.

Show child attributes

funnel

object | null

required

Null until the lane's first check has results.

Show child attributes

Overview

Endpoints

Update a lane

Authorizations

Path Parameters

Body

Response