Batch โ€” Multi-Slug

Batch, multi-slug refresh. Selection via location_ids body array or a filter[...] querystring; slugs via the body slugs array (omitted / "all" = every slug).

Request

Method & Path

POST /assessments/{location_type}/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