---
title: "Canonical values for agent config filters"
method: GET
path: "/business/agents/autocomplete"
tags: ["Agents"]
---

# Canonical values for agent config filters

`GET /business/agents/autocomplete`

## Request

- Base URL: `https://api.tryfuse.ai/api/v1`
- URL: `https://api.tryfuse.ai/api/v1/business/agents/autocomplete`
- Auth: HTTP basic

Resolves free text to the exact strings an agent config accepts, so a create body never fails on a near-miss spelling. `region` feeds `regions` and `authorLocation`; `industry` feeds `industries`; `title` feeds `currentTitle`, `pastTitle` and `authorTitle`; `school` is available for completeness. There is no country vocabulary: `region` returns LinkedIn geographies that include sub-national areas such as "California, United States", so it is NOT a source for `companyCountries` or `leadCompanyCountries` — those take full English country names only ("United States", "Germany") and no lookup endpoint serves them. Returns at most 10 values, best match first; an empty array means nothing matched — try a broader term. Counts against the agents bucket (30/min) and, upstream, a separate lookup bucket (120/min).

Errors:
- `400` `INVALID_REQUEST` — The agents service rejected the request for a reason this API does not model specifically. The request is not retryable unchanged.
- `422` `VALIDATION_FAILED` — The request failed this endpoint's own validation — `param` names the offending field and `message` says why.
- `429` `RATE_LIMITED` — The agents bucket is exhausted: 30 requests per minute or 2,000 per day per token owner, shared by every /business/agents operation (a 429 raised by the agents service is relayed with this code too). Retry after the `Retry-After` header.
- `500` `UNEXPECTED_ERROR` — The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quote `request_id` to support.

Requires one of the following token scopes: agents.

## Query parameters

- `field` 'region' | 'industry' | 'title' | 'school', required: Which vocabulary to search: region, industry, title or school. The returned strings are the exact values the agent config filters accept: region feeds `regions` and `authorLocation`, industry feeds `industries`, title feeds `currentTitle`, `pastTitle` and `authorTitle`. There is no country vocabulary here: region returns LinkedIn geographies that include sub-national areas such as "California, United States", so it is not a source for `companyCountries` or `leadCompanyCountries`, which take full English country names only.
- `q` string, required: Free-text term to resolve, 1-200 characters (e.g. "software", "united states", "vp of sales"). At most 10 canonical values are returned, best match first; an empty array means no match.

## Response `200`

Success

- object
  - `field` 'region' | 'industry' | 'title' | 'school', required: The vocabulary that was searched — echoed back from the request.
  - `suggestions` string[], required: Canonical values, best match first. Copy them verbatim into the agent config.

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `422`: Error
- `429`: Error
- `500`: Error

---

[API](https://skmtc.dev/fuseai/apis/fuse-business-api.md) · [All operations](https://skmtc.dev/fuseai/apis/fuse-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fuseai/apis/fuse-business-api/revisions/50d95e0536f4?raw)