---
title: "Compare explicit prior state with current state"
method: POST
path: "/api/sessions/{sessionId}/environments/{environmentId}/state/diff"
---

# Compare explicit prior state with current state

`POST /api/sessions/{sessionId}/environments/{environmentId}/state/diff`

## Path parameters

- `sessionId` string, required
- `environmentId` string, required

## Request body

- object
  - `source` 'explicit', required
  - `before` unknown, required
  - `maxChanges` integer

## Response `200`

Successful response

- object
  - `schema` 'archal.environment-state-diff', required
  - `version` 1, required
  - `sessionId` string, required
  - `environmentId` string, required
  - `beforeSha256` string, required
  - `afterSha256` string, required
  - `changed` boolean, required
  - `totalChanges` integer, required
  - `returnedChanges` integer, required
  - `truncated` boolean, required
  - `changes` object[], required
    - `op` 'add' | 'remove' | 'replace', required
    - `path` string, required
    - `before` unknown
    - `after` unknown

## Other responses

- `400` — The request was rejected
- `401` — The request was rejected
- `403` — The request was rejected
- `404` — The request was rejected
- `409` — The request was rejected
- `413` — The request was rejected
- `429` — The request was rejected
- `500` — The request was rejected
- `502` — The request was rejected
- `503` — The request was rejected

---

[API](https://skmtc.dev/archal/apis/archal-api.md) · [All operations](https://skmtc.dev/archal/apis/archal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archal/archal-api/revisions/a06cd479cc93/schema)