This page documents the canonical HTTP contract for this endpoint.
This session-only route requires a signed-in user JWT; developer API keys are blocked. providers is an optional list passed to the refresh job; the HTTP route does not define an enum, so omit it unless you have a provider value from the applicable product contract. use_geocoder and classify_public_docs both default to true. An optional Idempotency-Key (maximum 240 characters) identifies the request occurrence: replaying it with the same request returns the existing admission receipt; reuse with a different request can return 409. A queued receipt is not completed enrichment. The result URL in source.result_endpoint can be polled for terminal status.
Path parameters
company_idrequiredstring
Company ID.
| Name | Type | Description |
|---|---|---|
| company_idrequired | string | Company ID. |
Body parameters
providers· optionalarray<string>
Optional provider selection.
use_geocoder· optionalboolean
Use geocoding; default true.
classify_public_docs· optionalboolean
Classify public documents; default true.
| Name | Type | Description |
|---|---|---|
| providers | array<string> | Optional provider selection. |
| use_geocoder | boolean | Use geocoding; default true. |
| classify_public_docs | boolean | Classify public documents; default true. |
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid Company ID or Idempotency-Key longer than 240 characters. |
| 401 | Signed-in user JWT and organization/user context required. |
| 403 | Developer API keys are blocked for this session-only route. |
| 404 | Company not found. |
| 409 | Company has no domain, or the idempotency key conflicts with a different refresh request. |
