---
title: "Metadata-only update endpoint (PUT/PATCH)."
method: PATCH
path: "/agent-playground/graphs/{id}/versions/{version_id}/"
tags: ["agent-playground"]
---

# Metadata-only update endpoint (PUT/PATCH).

`PATCH /agent-playground/graphs/{id}/versions/{version_id}/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/agent-playground/graphs/{id}/versions/{version_id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Updates commit_message and/or promotes draft → active.
Content changes (nodes, ports, edges) are done via granular CRUD or create_version.

## Request body

- GraphList
  - `id` string, uuid
  - `name` string: Display name
  - `description` string, nullable
  - `is_template` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` UserBrief
    - `id` string, uuid
    - `name` string
    - `email` string, email
  - `collaborators` UserBrief[]
    - `id` string, uuid
    - `name` string
    - `email` string, email
  - `active_version_id` string, uuid
  - `active_version_number` integer
  - `node_count` integer

## Response `200`

OK

- GraphList
  - `id` string, uuid
  - `name` string: Display name
  - `description` string, nullable
  - `is_template` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` UserBrief
    - `id` string, uuid
    - `name` string
    - `email` string, email
  - `collaborators` UserBrief[]
    - `id` string, uuid
    - `name` string
    - `email` string, email
  - `active_version_id` string, uuid
  - `active_version_number` integer
  - `node_count` integer

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)