---
title: "Save Entity Graph Layout"
method: PUT
path: "/api/v1/ontology/entity-graph/layout"
tags: ["ontology-entities"]
---

# Save Entity Graph Layout

`PUT /api/v1/ontology/entity-graph/layout`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/ontology/entity-graph/layout`
- Auth: none declared

Replace the caller's own layout; positions of entities they cannot see are dropped.

## Request body

- EntityGraphLayoutUpdate: Input for PUT /ontology/entity-graph/layout: replaces the saved map.
  - `positions` object, required

## Response `200`

Successful Response

- EntityGraphLayoutRead: The caller's own entity graph layout, keyed by entity id. ``updated_at`` is null when the caller has not saved a layout.
  - `positions` object, required
  - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

> 61 revisions in range; 1 not diffed.

- **2026-10-27** `27bb0edb6c9c`: 1 breaking
  - removed the required property `can_edit` from the response with the `200` status
- **2026-10-26** `c974dbc9dc7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/ontology/entity-graph/layout/put.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/68e89013efe0?raw)