Update ICP

Update an existing Ideal Customer Profile (ICP).

Only the fields included in the request body will be modified - all other fields remain unchanged. The id field is always required to identify which ICP to update.

Before calling this endpoint, call GET /api/v1/icp/options to retrieve all valid values for employee_ranges, funding stages, locations, and sub_locations.

Required fields:

• id: The numeric ID of the ICP to update (returned by /api/v1/icp/list or /api/v1/icp/create).

Updatable fields (all optional - include only what you want to change):

• name: A descriptive name for the ICP. Must be non-empty and unique among the user’s ICPs.
• target_roles: List of job titles or role descriptions to target. Must contain at least one role if provided. Examples: [“Head of Engineering”, “VP of Product”].
• employee_ranges: Company size filters. Provide one or more range labels from the employee_ranges list returned by /api/v1/icp/options. Must contain at least one range if provided.
• location: List of company HQ location codes. Use the value field from the locations list returned by /api/v1/icp/options (e.g., [“us”, “uk”]). Must contain at least one location if provided.
• min_funding / max_funding: Funding stage bounds. Each can be updated independently. Set to null to clear (stored as "Any"). A value of "Any" means no constraint on that bound. Use values from the funding_stages list returned by /api/v1/icp/options.
• employee_count_funding_config: How to combine employee count and funding criteria. Values: "AND" or "OR". Only valid when funding is set. Set to null to clear.
• sub_locations: US state or city codes. Use the value field from the sub_locations list returned by /api/v1/icp/options (e.g., [“ca”, “san-francisco-ca”]). Only applicable when location is exclusively ["us"]. Set to null or [] to clear. If changing location away from ["us"], you must also clear this field.
• people_locations: Geographic filter for target people. Use the value field from the people_locations list returned by /api/v1/icp/options. Set to null or [] to clear.
• people_sub_locations: Sub-region codes for people locations. Use the value field from the people_sub_locations list returned by /api/v1/icp/options. Only applicable when people_locations is exclusively ["us"]. Set to null or [] to clear. If changing people_locations away from ["us"], you must also clear this field.

Cross-field validation:

• sub_locations requires location to be ["us"] (checked against the final merged state, not just the request).
• people_sub_locations requires people_locations to be ["us"].
• employee_count_funding_config requires at least one of min_funding or max_funding to be a non-"Any" value.

PATCH /api/v1/icp/update

Update ICP

cURL

curl --request PATCH \
  --url https://api.openfunnel.dev/api/v1/icp/update \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "id": 123,
  "name": "<string>",
  "target_roles": [
    "<string>"
  ],
  "employee_ranges": [
    "<string>"
  ],
  "min_funding": "<string>",
  "max_funding": "<string>",
  "location": [
    "<string>"
  ],
  "sub_locations": [
    "<string>"
  ],
  "people_locations": [
    "<string>"
  ],
  "people_sub_locations": [
    "<string>"
  ]
}
'

200

{
  "icp": {
    "id": 123,
    "name": "<string>",
    "target_roles": [
      "<string>"
    ],
    "min_employee": 123,
    "max_employee": 123,
    "min_funding": "<string>",
    "max_funding": "<string>",
    "location": [
      "<string>"
    ],
    "sub_locations": [
      "<string>"
    ],
    "people_locations": [
      "<string>"
    ],
    "people_sub_locations": [
      "<string>"
    ],
    "employee_count_funding_config": "<string>"
  }
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

id · integer · required

name · string | null

target_roles · string[] | null

employee_ranges · string[] | null

min_funding · string | null

max_funding · string | null

employee_count_funding_config · enum<string> | null

Available options: AND, OR

location · string[] | null

sub_locations · string[] | null

people_locations · string[] | null

people_sub_locations · string[] | null

Response

200

application/json

Successful Response

icp · ICPItem · object · required

Show child attributes