---
title: "Diff Manifest"
method: POST
path: "/v1/manifest/diff"
tags: ["Manifest"]
---

# Diff Manifest

`POST /v1/manifest/diff`

Compare a manifest file with current state.

Shows resources that would be:
- **Created**: In manifest but not in system
- **In system only**: In system but not in manifest
- **Different**: In both but with configuration differences

This is useful for understanding what changes would occur
before applying a manifest.

**Example:**
```bash
curl -X POST /v1/manifest/diff \
  -H "Authorization: Bearer $API_KEY" \
  -F "manifest_file=@mixpeek.yaml"
```

## Response `200`

Successful Response

- DiffResult — Result of comparing manifest to current state.
  - `to_create` DiffItem[] — Resources in manifest but not in system
    - `resource_type` string, required — Type of resource
    - `name` string, required — Resource name
    - `action` string, required — Action: create, update, delete, unchanged
    - `details` string, nullable — Details about the difference
  - `in_system_only` DiffItem[] — Resources in system but not in manifest
    - `resource_type` string, required — Type of resource
    - `name` string, required — Resource name
    - `action` string, required — Action: create, update, delete, unchanged
    - `details` string, nullable — Details about the difference
  - `differences` DiffItem[] — Resources in both with differences
    - `resource_type` string, required — Type of resource
    - `name` string, required — Resource name
    - `action` string, required — Action: create, update, delete, unchanged
    - `details` string, nullable — Details about the difference

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/220a3b263fda/schema)