Single Location โ Single-Slug
Single location, single slug โ the most specific shape.
โถRequest
โถMethod & Path
POST /assessments/{location_type}/{id}/{slug}/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