---
title: "Run a resilience assessment"
method: POST
path: "/api/resilience/assess"
---

# Run a resilience assessment

`POST /api/resilience/assess`

Executes the resilience MAF workflow over the user's facility registry,
fusing live weather + supply graph + business-continuity context.
Returns one dossier per facility, ranked by severity.

## Request body

- AssessRequest
  - `region_filter` string — Optional region filter, e.g. `TX`. Omit to assess all visible facilities.
  - `horizon_days` integer
  - `hazards` string[] — Subset of supported hazards. Omit to run all.
  - `user_query` string — Optional natural-language ask for context-grounding.

## Response `200`

Assessment dossier

- AssessResponse
  - `assessment_id` string, uuid, required — Stable id for follow-up calls (e.g. `getResilienceSnapshot`).
  - `generated_at` string, date-time
  - `horizon_days` integer
  - `hazards` string[]
  - `region_filter` string, nullable
  - `facilities` FacilityDossier[], required
    - `facility_id` string, required
    - `name` string, required
    - `lat` number
    - `lng` number
    - `overall_score` number, float, required
    - `severity` 'low' | 'moderate' | 'high' | 'severe', required
    - `dimensions` object
    - `impacted_by` object[]
      - `src_id` string
      - `hazard` string
      - `score` number
      - `edge_kind` string
      - `lead_time_days` integer
    - `deep_link` string, uri — URL into the Planetary Explorer web UI scoped to this facility.
  - `data_provenance` Provenance[]
    - `source` string
    - `ref` string
    - `retrieved_at` string, date-time

## Other responses

- `401` — Missing or invalid bearer token
- `502` — Upstream error (weather, Fabric, or workflow failure)
- `503` — Resilience subsystem not configured or temporarily unavailable

---

[API](https://skmtc.net/azure/apis/planetary-explorer-resilience-api.md) · [All operations](https://skmtc.net/azure/apis/planetary-explorer-resilience-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/planetary-explorer-resilience-api/versions/8882a2be335b/schema)