---
title: "Get Situation Brief"
method: GET
path: "/situations/{id}/brief"
tags: ["Situations"]
---

# Get Situation Brief

`GET /situations/{id}/brief`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/situations/{id}/brief`
- Auth: one of:
  - `app-cookie` (defined in the document in a form this page cannot read)
  - HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

OK

- GetSituationBriefResponseBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` SituationBrief, required
    - `changes` SituationBriefChanges, required
      - `available` boolean, required: Whether any integration reports deployments
      - `end` string, date-time, required
      - `openedAt` string, date-time, required
      - `services` SituationBriefServiceChanges[], required
        - `deployments` SituationBriefDeployment[], required: After the situation opened, then before it, each newest first
          - `afterOpened` boolean, required
          - `deployedAt` string, date-time, required
          - `environment` string, required
          - `id` string, required: The deployment's knowledge entity
          - `latestEvidenceId` string
          - `mergedChanges` SituationBriefMergedChange[], required
            - `author` string, required
            - `id` string, required: The change's knowledge entity
            - `link` 'merge_commit' | 'merged_since_previous_deployment' | 'merged_in_lookback', required
            - `mergedAt` string, date-time, required
            - `number` integer, required
            - `title` string, required
            - `url` string, required
          - `mergedChangesCut` boolean, required
          - `mergedChangesUnlinked` '' | 'no_repository' | 'repository_not_from_code_forge', required
          - `repositoryName` string, required
          - `sha` string, required
          - `status` string, required
          - `url` string, required
          - `version` string, required
        - `limits` string[], required
        - `serviceId` string, required
      - `start` string, date-time, required
      - `unavailableReason` string, required
    - `services` SituationBriefService[], required: Matching services first, then by name, at most 10
      - `displayName` string, required
      - `entityId` string, required
      - `unconfirmedMatches` SituationUnconfirmedMatch[], required
        - `displayName` string, required
        - `entityId` string, required
        - `proposalId` string, required
        - `rationale` string, required
        - `value` string, required
    - `unseen` SituationBriefUnseen[], required
      - `kind` 'source_unavailable' | 'services_cut' | 'not_read', required
      - `text` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-16** (v1) `a5fa344e3b61`: 1 breaking, 1 info
  - removed the required property `data/services/items/unconfirmedMatches/items/name` from the response with the `200` status
  - added the required property `data/services/items/unconfirmedMatches/items/value` to the response with the `200` status
- **2026-10-15** (v1) `c072c5144889`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rezible/apis/rezible-api/changes/situations/:id/brief/get.md)

---

[API](https://skmtc.dev/rezible/apis/rezible-api.md) - [All operations](https://skmtc.dev/rezible/apis/rezible-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rezible/apis/rezible-api/revisions/8ade2eed962f?raw)