---
title: "Bulk soft-delete graphs with reference validation."
method: POST
path: "/agent-playground/graphs/delete/"
tags: ["agent-playground"]
---

# Bulk soft-delete graphs with reference validation.

`POST /agent-playground/graphs/delete/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/agent-playground/graphs/delete/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Accepts a list of graph IDs. Before deleting, checks if any graph version
being deleted is referenced by nodes in graphs outside the deletion set.
If all referencing graphs are also being deleted, it's allowed; otherwise blocked.

## 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 `201`

Created

- 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)