Register a new GraphID

PUT

/graph/v1

curl --request PUT \
  --url https://example.com/graph/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "graph_id": "00000000-0000-0000-0000-000000000000", "name": "First Graph", "parent_id": "00000000-0000-0000-0000-000000000011" }'

Register a new GraphID

Authorizations

• Bearer

Request Body ^required

Media type application/json

object

graph_id

required

string

Example

00000000-0000-0000-0000-000000000000

name

required

string

Example

First Graph

parent_id

string

nullable

Example

00000000-0000-0000-0000-000000000011

Responses

201

New graph registered

400

Parent graph does not exist (only without authentication; with it an unknown parent is a 403, so callers cannot probe for graph ids)

403

Caller lacks create_projects (new root graph) or create_declarations on the parent’s project (child graph, or re-registering an existing graph); or the parent graph is unknown

409

Graph was already registered (caller holds create_declarations on its project, or create_projects for a root)