Batch โ Single-Slug or Single Multi-Slug
Two-segment form: the middle segment is a slug (batch single-slug) or a uuid (single-location multi-slug) โ disambiguated by the handler.
โถRequest
โถMethod & Path
POST /assessments/{location_type}/{idOrSlug}/refresh
โถBody / Query
location_ids(body, โค 10,000) orfilter[...](query) or a path:idโ exactly one selection.slugs(body array) or the path:slugโ never both. Omitted /"all"expands to every slug.?force=trueโ bypass the 24h freshness window and re-run everything.?retry=failed_only&from=<prior-task-id>โ re-run only the failed subset of a prior task.
โถResponse
- 202 โ Accepted; body carries the
assessment_taskresource and ameta.pollhint. PollGET /assessments/tasks/{id}until terminal. - 400 โ Invalid selection (e.g. both
slugsand path slug), or a by-filterselection resolving to > 10,000 locations. - 404 โ A single / by-list
:idthe caller's orgs cannot see. - 429 โ Per-organization in-flight refresh concurrency cap exceeded.
See Refresh semantics for the full selection / dedup / freshness contract.
Required scope:
assessments:write