---
title: "Approve a schema graph diff"
method: POST
path: "/v1/schema-graph/diffs/{id}/approve"
tags: ["Schemas"]
---

# Approve a schema graph diff

`POST /v1/schema-graph/diffs/{id}/approve`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/schema-graph/diffs/{id}/approve`
- Auth: HTTP bearer

Approve a pending diff, promoting the changes to the live class version.

## Path parameters

- `id` string, uuid, required

## Response `200`

Diff approved.

- SchemaGraphDiffResponse
  - `id` string, uuid, required
  - `class_id` string, uuid, required
  - `from_version` integer, nullable
  - `to_version` integer, nullable
  - `status` 'pending' | 'approved' | 'rejected', required
  - `changes` object[]: List of field additions, removals, and modifications.
  - `created_at` string, date-time, required
  - `decided_at` string, date-time, nullable

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)