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) or filter[...] (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_task resource and a meta.poll hint. Poll GET /assessments/tasks/{id} until terminal.
  • 400 โ€” Invalid selection (e.g. both slugs and path slug), or a by-filter selection resolving to > 10,000 locations.
  • 404 โ€” A single / by-list :id the 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