#GraphViews

---

#GET /{o}/{p}/graph-views

List graph views

List project-scope saved views plus the caller's own personal views.

Auth: Bearer token required · Permission: graph:read

Path parameters

Name	Type	Description
o	string
p	string

Responses

Status	Description	Schema
200	OK	GraphViewList
401	Unauthorized	Error
403	Forbidden	Error

---

#POST /{o}/{p}/graph-views

Create a graph view

Create a user- or project-scope saved view. Project-scope writes require admin/owner (graph:manage).

Auth: Bearer token required · Permission: graph:write

Path parameters

Name	Type	Description
o	string
p	string

Request body (application/json)

Field	Type	Description
name	string	(required)
scope	user | project	(required)
pinnedPositions	object | null
viewSpec	object | null

Responses

Status	Description	Schema
201	Created	GraphView
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/graph-views/default

Get the default graph view

Resolves the caller's default view: personal default → project default → synthetic Fleet fallback.

Auth: Bearer token required · Permission: graph:read

Path parameters

Name	Type	Description
o	string
p	string

Responses

Status	Description	Schema
200	OK	DefaultGraphView
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/graph-views/{id}

Get a graph view by id

Auth: Bearer token required · Permission: graph:read

Path parameters

Name	Type	Description
o	string
p	string
id	string

Responses

Status	Description	Schema
200	OK	GraphView
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#PUT /{o}/{p}/graph-views/{id}

Update a graph view

Auth: Bearer token required · Permission: graph:write

Path parameters

Name	Type	Description
o	string
p	string
id	string

Request body (application/json)

Field	Type	Description
name	string
pinnedPositions	object | null
viewSpec	object | null

Responses

Status	Description	Schema
200	OK	GraphView
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#DELETE /{o}/{p}/graph-views/{id}

Delete a graph view

Auth: Bearer token required · Permission: graph:write

Path parameters

Name	Type	Description
o	string
p	string
id	string

Responses

Status	Description	Schema
200	OK	DeletedById
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

---

#PATCH /{o}/{p}/graph-views/{id}/default

Set a graph view as the default

Atomically clear the prior default within the view's (scope, owner) group and set this one.

Auth: Bearer token required · Permission: graph:write

Path parameters

Name	Type	Description
o	string
p	string
id	string

Responses

Status	Description	Schema
200	OK	GraphView
401	Unauthorized	Error
403	Forbidden	Error
404	Not Found	Error

#Schemas

#DefaultGraphView

Field	Type	Description
id	string(uuid) | null	(required)
orgId	string	(required)
projectId	string	(required)
scope	user | project	(required)
ownerUserId	string | null	(required)
name	string	(required)
isDefault	boolean	(required)
pinnedPositions	object | null	(required)
viewSpec	object | null	(required)
createdAt	string | string
updatedAt	string | string

#DeletedById

Field	Type	Description
deleted	true	(required)
id	string	(required)

#Error

Field	Type	Description
error	string	(required)
code	string

#GraphView

Field	Type	Description
id	string(uuid)	(required)
orgId	string	(required)
projectId	string	(required)
scope	user | project	(required)
ownerUserId	string | null	(required)
name	string	(required)
isDefault	boolean	(required)
pinnedPositions	object | null	(required)
viewSpec	object | null	(required)
createdAt	string | string	(required)
updatedAt	string | string	(required)

#GraphViewList

Type: GraphView[]