@3sixty/auditable-item-graph-service 0.0.0-stage → 0.20.0-next.1

package/docs/open-api/spec.json

@@ -0,0 +1,2190 @@
+{
+	"openapi": "3.1.1",
+	"info": {
+		"title": "3Sixty - Test Endpoints",
+		"description": "REST API for 3Sixty - Test Endpoints.",
+		"version": "1.0.0",
+		"license": {
+			"name": "Apache 2.0 License",
+			"url": "https://opensource.org/licenses/Apache-2.0"
+		}
+	},
+	"servers": [
+		{
+			"url": "https://localhost"
+		}
+	],
+	"tags": [
+		{
+			"name": "Auditable Item Graph",
+			"description": "Endpoints which are modelled to access an auditable item graph contract."
+		}
+	],
+	"paths": {
+		"/auditable-item-graph": {
+			"post": {
+				"operationId": "auditableItemGraphCreate",
+				"summary": "Create a new graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Create an auditable item graph vertex.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/AuditableItemGraphCreateRequest"
+							},
+							"examples": {
+								"auditableItemGraphCreateRequestExample": {
+									"value": {
+										"@context": [
+											"https://schema.3sixty.global/aig/",
+											"https://schema.3sixty.global/common/"
+										],
+										"type": "AuditableItemGraphVertex",
+										"annotationObject": {
+											"@context": "https://schema.org",
+											"@type": "Note",
+											"content": "This is a simple note"
+										},
+										"aliases": [
+											{
+												"type": "AuditableItemGraphAlias",
+												"id": "bar456",
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphAlias",
+												"id": "foo321",
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										],
+										"resources": [
+											{
+												"type": "AuditableItemGraphResource",
+												"id": "resource1",
+												"resourceObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphResource",
+												"id": "resource2",
+												"resourceObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										],
+										"edges": [
+											{
+												"type": "AuditableItemGraphEdge",
+												"targetId": "aig:1234567890",
+												"edgeRelationships": [
+													"frenemy"
+												],
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphEdge",
+												"targetId": "aig:45678901234",
+												"edgeRelationships": [
+													"end"
+												],
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										]
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"201": {
+						"description": "The rest request ended in created response.",
+						"headers": {
+							"location": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. aig%3A1234567890"
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
+			"get": {
+				"operationId": "auditableItemGraphList",
+				"summary": "Query graph vertices by id or alias",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id or alias to try and find.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "idMode",
+						"description": "Which field to look in with the id, defaults to both.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"anyOf": [
+								{
+									"const": "id"
+								},
+								{
+									"const": "alias"
+								},
+								{
+									"const": "both"
+								}
+							]
+						}
+					},
+					{
+						"name": "idExact",
+						"description": "Find only exact matches, default to false meaning partial matching.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "resourceTypes",
+						"description": "Include vertices with specific resource types, comma separated.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "conditions",
+						"description": "The conditions to filter the streams, JSON stringified `EntityCondition<IAuditableItemGraphVertex>`.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "orderBy",
+						"description": "The order for the results, default to dateCreated.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"enum": [
+								"dateCreated",
+								"dateModified"
+							]
+						}
+					},
+					{
+						"name": "orderByDirection",
+						"description": "The direction for the order, defaults to desc.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"$ref": "#/components/schemas/SortDirection"
+						}
+					},
+					{
+						"name": "properties",
+						"description": "The properties to return as a comma separated list, defaults to \"id,dateCreated,aliases,annotationObject\".",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "cursor",
+						"description": "The optional cursor to get next chunk.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "limit",
+						"description": "The maximum number of entities to return, a page can contain fewer so follow the cursor\nuntil it is absent to read them all.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "The response to getting the a list of the vertices with matching ids or aliases.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertexList"
+								},
+								"examples": {
+									"auditableItemGraphListResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphVertexList"
+											],
+											"itemListElement": [
+												{
+													"@context": [
+														"https://schema.3sixty.global/aig/",
+														"https://schema.3sixty.global/common/",
+														"https://schema.org"
+													],
+													"type": "AuditableItemGraphVertex",
+													"id": "0101010101010101010101010101010101010101010101010101010101010101",
+													"dateCreated": "2024-08-22T11:55:16.271Z",
+													"aliases": [
+														{
+															"@context": [
+																"https://schema.3sixty.global/aig/",
+																"https://schema.3sixty.global/common/",
+																"https://schema.org"
+															],
+															"type": "AuditableItemGraphAlias",
+															"id": "foo4",
+															"dateCreated": "2024-08-22T11:55:16.271Z"
+														}
+													]
+												}
+											]
+										}
+									}
+								}
+							},
+							"application/ld+json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertexList"
+								},
+								"examples": {
+									"auditableItemGraphJsonLdListResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphVertexList"
+											],
+											"itemListElement": [
+												{
+													"@context": [
+														"https://schema.3sixty.global/aig/",
+														"https://schema.3sixty.global/common/",
+														"https://schema.org"
+													],
+													"type": "AuditableItemGraphVertex",
+													"id": "0101010101010101010101010101010101010101010101010101010101010101",
+													"dateCreated": "2024-08-22T11:55:16.271Z",
+													"aliases": [
+														{
+															"@context": [
+																"https://schema.3sixty.global/aig/",
+																"https://schema.3sixty.global/common/",
+																"https://schema.org"
+															],
+															"type": "AuditableItemGraphAlias",
+															"id": "foo4",
+															"dateCreated": "2024-08-22T11:55:16.271Z"
+														}
+													]
+												}
+											]
+										}
+									}
+								}
+							}
+						},
+						"headers": {
+							"content-type": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. application/ld+json"
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}": {
+			"get": {
+				"operationId": "auditableItemGraphGet",
+				"summary": "Get a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "includeDeleted",
+						"description": "Whether to include deleted aliases, resource, edges, defaults to false.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "verifySignatureDepth",
+						"description": "How many signatures to verify, none, current or all, defaults to \"none\".",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"$ref": "#/components/schemas/VerifyDepth"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting an auditable item graph vertex.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertex"
+								},
+								"examples": {
+									"auditableItemGraphGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/",
+												"https://schema.org"
+											],
+											"type": "AuditableItemGraphVertex",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"dateModified": "2024-08-22T11:55:16.271Z",
+											"annotationObject": {
+												"@context": "https://schema.org",
+												"@type": "Note",
+												"content": "This is a simple note"
+											},
+											"aliases": [
+												{
+													"@context": [
+														"https://schema.3sixty.global/aig/",
+														"https://schema.3sixty.global/common/",
+														"https://schema.org"
+													],
+													"type": "AuditableItemGraphAlias",
+													"id": "tst:1234567890",
+													"dateCreated": "2024-08-22T11:55:16.271Z"
+												}
+											]
+										}
+									}
+								}
+							},
+							"application/ld+json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertex"
+								},
+								"examples": {
+									"auditableItemGraphJsonLdGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/",
+												"https://schema.org"
+											],
+											"type": "AuditableItemGraphVertex",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"dateModified": "2024-08-22T11:55:16.271Z",
+											"annotationObject": {
+												"@context": "https://schema.org",
+												"@type": "Note",
+												"content": "This is a simple note"
+											},
+											"aliases": [
+												{
+													"@context": [
+														"https://schema.3sixty.global/aig/",
+														"https://schema.3sixty.global/common/",
+														"https://schema.org"
+													],
+													"type": "AuditableItemGraphAlias",
+													"dateCreated": "2024-08-22T11:55:16.271Z",
+													"id": "tst:1234567890"
+												}
+											]
+										}
+									}
+								}
+							}
+						},
+						"headers": {
+							"content-type": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. application/ld+json"
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
+			"put": {
+				"operationId": "auditableItemGraphUpdate",
+				"summary": "Update a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex to update.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Update an auditable item graph vertex (PUT - full replacement of vertex state).",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/AuditableItemGraphUpdateRequest"
+							},
+							"examples": {
+								"auditableItemGraphUpdateRequestExample": {
+									"value": {
+										"@context": [
+											"https://schema.3sixty.global/aig/",
+											"https://schema.3sixty.global/common/"
+										],
+										"type": "AuditableItemGraphVertex",
+										"annotationObject": {
+											"@context": "https://schema.org",
+											"@type": "Note",
+											"content": "This is a simple note"
+										},
+										"aliases": [
+											{
+												"type": "AuditableItemGraphAlias",
+												"id": "bar456",
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphAlias",
+												"id": "foo321",
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										],
+										"resources": [
+											{
+												"type": "AuditableItemGraphResource",
+												"id": "resource1",
+												"resourceObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphResource",
+												"id": "resource2",
+												"resourceObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										],
+										"edges": [
+											{
+												"type": "AuditableItemGraphEdge",
+												"id": "edge1",
+												"targetId": "aig:1234567890",
+												"edgeRelationships": [
+													"frenemy"
+												],
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											},
+											{
+												"type": "AuditableItemGraphEdge",
+												"id": "edge2",
+												"targetId": "aig:45678901234",
+												"edgeRelationships": [
+													"end"
+												],
+												"annotationObject": {
+													"@context": "https://schema.org",
+													"@type": "Note",
+													"content": "This is a simple note"
+												}
+											}
+										]
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"204": {
+						"description": "The rest request ended in success with no data."
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
+			"patch": {
+				"operationId": "auditableItemGraphUpdatePartial",
+				"summary": "Partially update a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex to update.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Partially update an auditable item graph vertex (PATCH - explicit list patches).",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/AuditableItemGraphUpdatePartialRequest"
+							},
+							"examples": {
+								"auditableItemGraphUpdatePartialRequestExample": {
+									"value": {
+										"@context": [
+											"https://schema.3sixty.global/aig/",
+											"https://schema.3sixty.global/common/"
+										],
+										"edgePatches": {
+											"add": [
+												{
+													"type": "AuditableItemGraphEdge",
+													"targetId": "aig:45678901234",
+													"edgeRelationships": [
+														"document"
+													]
+												}
+											]
+										}
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"204": {
+						"description": "The rest request ended in success with no data."
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}/versions/{version}": {
+			"get": {
+				"operationId": "auditableItemGraphVersionGet",
+				"summary": "Get a graph vertex at a specific version",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "version",
+						"description": "The version number to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "1"
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting an auditable item graph vertex at a specific version.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertex"
+								},
+								"examples": {
+									"auditableItemGraphVersionGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/",
+												"https://schema.org"
+											],
+											"type": "AuditableItemGraphVertex",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"version": 1
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}/versions": {
+			"get": {
+				"operationId": "auditableItemGraphVersionList",
+				"summary": "Get all versions of a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "after",
+						"description": "Only return versions created after this ISO 8601 timestamp (exclusive).",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "before",
+						"description": "Only return versions created before this ISO 8601 timestamp (exclusive).",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting all versions of an auditable item graph vertex.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphVertexVersionList"
+								},
+								"examples": {
+									"auditableItemGraphVersionListResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphVertexVersionList"
+											],
+											"itemListElement": [
+												{
+													"version": 0,
+													"dateCreated": "2024-08-22T11:55:16.271Z"
+												},
+												{
+													"version": 1,
+													"dateCreated": "2024-08-22T11:56:00.000Z"
+												},
+												{
+													"version": 2,
+													"dateCreated": "2024-08-22T11:57:00.000Z"
+												}
+											]
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}/changesets/{changesetId}": {
+			"get": {
+				"operationId": "auditableItemGraphChangesetGet",
+				"summary": "Get a graph vertex changeset",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex to get the changeset from.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "changesetId",
+						"description": "The id of the changeset to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "changeset:1234567890"
+					},
+					{
+						"name": "verifySignatureDepth",
+						"description": "How many signatures to verify, none, current or all, defaults to \"none\".",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"$ref": "#/components/schemas/VerifyDepth"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting an auditable item graph vertex changeset.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphChangeset"
+								},
+								"examples": {
+									"auditableItemGraphChangesetGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/"
+											],
+											"type": "AuditableItemGraphChangeset",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"patches": [
+												{
+													"type": "AuditableItemGraphPatchOperation",
+													"patchOperation": "add",
+													"patchPath": "/annotationObject",
+													"patchValue": {
+														"@context": "https://www.w3.org/ns/activitystreams",
+														"type": "Create",
+														"actor": {
+															"type": "Person",
+															"id": "acct:person@example.org",
+															"name": "Person"
+														},
+														"object": {
+															"type": "Note",
+															"content": "This is a simple note"
+														},
+														"published": "2015-01-25T12:34:56Z"
+													}
+												},
+												{
+													"type": "AuditableItemGraphPatchOperation",
+													"patchOperation": "add",
+													"patchPath": "/aliases",
+													"patchValue": [
+														{
+															"id": "foo123",
+															"dateCreated": "2015-01-25T12:34:56Z"
+														},
+														{
+															"id": "bar456",
+															"dateCreated": "2015-01-25T12:34:56Z"
+														}
+													]
+												}
+											],
+											"verification": {
+												"@context": "https://schema.3sixty.global/immutable-proof/",
+												"type": "ImmutableProofVerification",
+												"verified": true
+											}
+										}
+									}
+								}
+							},
+							"application/ld+json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphChangeset"
+								},
+								"examples": {
+									"auditableItemGraphChangesetJsonLdGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/",
+												"https://schema.org"
+											],
+											"type": "AuditableItemGraphChangeset",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"patches": [
+												{
+													"type": "AuditableItemGraphPatchOperation",
+													"patchOperation": "add",
+													"patchPath": "/annotationObject",
+													"patchValue": {
+														"@context": "https://www.w3.org/ns/activitystreams",
+														"type": "Create",
+														"actor": {
+															"type": "Person",
+															"id": "acct:person@example.org",
+															"name": "Person"
+														},
+														"object": {
+															"type": "Note",
+															"content": "This is a simple note"
+														},
+														"published": "2015-01-25T12:34:56Z"
+													}
+												},
+												{
+													"type": "AuditableItemGraphPatchOperation",
+													"patchOperation": "add",
+													"patchPath": "/aliases",
+													"patchValue": [
+														{
+															"id": "foo123",
+															"dateCreated": "2015-01-25T12:34:56Z"
+														},
+														{
+															"id": "bar456",
+															"dateCreated": "2015-01-25T12:34:56Z"
+														}
+													]
+												}
+											],
+											"verification": {
+												"@context": "https://schema.3sixty.global/immutable-proof/",
+												"type": "ImmutableProofVerification",
+												"verified": true
+											}
+										}
+									}
+								}
+							}
+						},
+						"headers": {
+							"content-type": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. application/ld+json"
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}/changesets": {
+			"get": {
+				"operationId": "auditableItemGraphChangesetList",
+				"summary": "Get a list of graph vertex changesets",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the changeset to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "cursor",
+						"description": "The optional cursor to get next chunk.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "limit",
+						"description": "Limit the number of entities to return.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "verifySignatureDepth",
+						"description": "How many signatures to verify, none, current or all, defaults to \"none\".",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"$ref": "#/components/schemas/VerifyDepth"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting an auditable item graph vertex changeset.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphChangesetList"
+								},
+								"examples": {
+									"auditableItemGraphChangesetListResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphChangesetList"
+											],
+											"itemListElement": [
+												{
+													"type": "AuditableItemGraphChangeset",
+													"id": "aig:1234567890",
+													"dateCreated": "2024-08-22T11:55:16.271Z",
+													"patches": [
+														{
+															"type": "AuditableItemGraphPatchOperation",
+															"patchOperation": "add",
+															"patchPath": "/annotationObject",
+															"patchValue": {
+																"@context": "https://www.w3.org/ns/activitystreams",
+																"type": "Create",
+																"actor": {
+																	"type": "Person",
+																	"id": "acct:person@example.org",
+																	"name": "Person"
+																},
+																"object": {
+																	"type": "Note",
+																	"content": "This is a simple note"
+																},
+																"published": "2015-01-25T12:34:56Z"
+															}
+														},
+														{
+															"type": "AuditableItemGraphPatchOperation",
+															"patchOperation": "add",
+															"patchPath": "/aliases",
+															"patchValue": [
+																{
+																	"id": "foo123",
+																	"dateCreated": "2015-01-25T12:34:56Z"
+																},
+																{
+																	"id": "bar456",
+																	"dateCreated": "2015-01-25T12:34:56Z"
+																}
+															]
+														}
+													],
+													"verification": {
+														"@context": "https://schema.3sixty.global/immutable-proof/",
+														"type": "ImmutableProofVerification",
+														"verified": true
+													}
+												}
+											]
+										}
+									}
+								}
+							},
+							"application/ld+json": {
+								"schema": {
+									"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphChangeset"
+								},
+								"examples": {
+									"auditableItemGraphChangesetJsonLdGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.3sixty.global/aig/",
+												"https://schema.3sixty.global/common/",
+												"https://schema.org"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphChangesetList"
+											],
+											"itemListElement": [
+												{
+													"type": "AuditableItemGraphChangeset",
+													"id": "aig:1234567890",
+													"dateCreated": "2024-08-22T11:55:16.271Z",
+													"patches": [
+														{
+															"type": "AuditableItemGraphPatchOperation",
+															"patchOperation": "add",
+															"patchPath": "/annotationObject",
+															"patchValue": {
+																"@context": "https://www.w3.org/ns/activitystreams",
+																"type": "Create",
+																"actor": {
+																	"type": "Person",
+																	"id": "acct:person@example.org",
+																	"name": "Person"
+																},
+																"object": {
+																	"type": "Note",
+																	"content": "This is a simple note"
+																},
+																"published": "2015-01-25T12:34:56Z"
+															}
+														},
+														{
+															"type": "AuditableItemGraphPatchOperation",
+															"patchOperation": "add",
+															"patchPath": "/aliases",
+															"patchValue": [
+																{
+																	"id": "foo123",
+																	"dateCreated": "2015-01-25T12:34:56Z"
+																},
+																{
+																	"id": "bar456",
+																	"dateCreated": "2015-01-25T12:34:56Z"
+																}
+															]
+														}
+													],
+													"verification": {
+														"@context": "https://schema.3sixty.global/immutable-proof/",
+														"type": "ImmutableProofVerification",
+														"verified": true
+													}
+												}
+											]
+										}
+									}
+								}
+							}
+						},
+						"headers": {
+							"content-type": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. application/ld+json"
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/auditable-item-graph/{id}/proof": {
+			"delete": {
+				"operationId": "auditableItemGraphRemoveProof",
+				"summary": "Remove the notarization proof from all changesets of a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex whose proof should be removed.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "0101010101010101010101010101010101010101010101010101010101010101"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"204": {
+						"description": "The rest request ended in success with no data."
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		}
+	},
+	"components": {
+		"schemas": {
+			"AuditableItemGraphCreateRequest": {
+				"description": "The data to be used in the vertex.",
+				"type": "object",
+				"properties": {
+					"dateCreated": {
+						"type": "string",
+						"description": "The date/time of when the element was created."
+					},
+					"dateModified": {
+						"type": "string",
+						"description": "The date/time of when the element was modified."
+					},
+					"dateDeleted": {
+						"type": "string",
+						"description": "The date/time of when the element was deleted, as we never actually remove items."
+					},
+					"@context": {
+						"type": "array",
+						"prefixItems": [
+							{
+								"const": "https://schema.3sixty.global/aig/"
+							},
+							{
+								"const": "https://schema.3sixty.global/common/"
+							}
+						],
+						"items": {
+							"$ref": "https://schema.3sixty.global/json-ld/JsonLdContextDefinitionElement"
+						},
+						"minItems": 2,
+						"description": "JSON-LD Context."
+					},
+					"type": {
+						"const": "AuditableItemGraphVertex",
+						"description": "JSON-LD Type."
+					},
+					"organizationIdentity": {
+						"type": "string",
+						"description": "The identity of the organization which controls the vertex."
+					},
+					"auditMode": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphAuditMode"
+					},
+					"annotationObject": {
+						"$ref": "https://schema.3sixty.global/json-ld/JsonLdNodeObject"
+					},
+					"aliases": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphAlias"
+						},
+						"description": "Alternative aliases that can be used to identify the vertex."
+					},
+					"resources": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphResource"
+						},
+						"description": "The resources attached to the vertex."
+					},
+					"edges": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphEdge"
+						},
+						"description": "Edges connected to the vertex."
+					},
+					"verified": {
+						"type": "boolean",
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
+					},
+					"version": {
+						"type": "number",
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
+					}
+				},
+				"required": [
+					"@context",
+					"type"
+				]
+			},
+			"AuditableItemGraphUpdatePartialRequest": {
+				"description": "Partial vertex data; only defined properties are applied.\nSub-lists use `{ add, remove }` patch objects.",
+				"type": "object",
+				"properties": {
+					"dateCreated": {
+						"type": "string",
+						"description": "The date/time of when the element was created."
+					},
+					"dateModified": {
+						"type": "string",
+						"description": "The date/time of when the element was modified."
+					},
+					"dateDeleted": {
+						"type": "string",
+						"description": "The date/time of when the element was deleted, as we never actually remove items."
+					},
+					"@context": {
+						"type": "array",
+						"prefixItems": [
+							{
+								"const": "https://schema.3sixty.global/aig/"
+							},
+							{
+								"const": "https://schema.3sixty.global/common/"
+							}
+						],
+						"items": {
+							"$ref": "https://schema.3sixty.global/json-ld/JsonLdContextDefinitionElement"
+						},
+						"minItems": 2,
+						"description": "JSON-LD Context."
+					},
+					"organizationIdentity": {
+						"type": "string",
+						"description": "The identity of the organization which controls the vertex."
+					},
+					"auditMode": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphAuditMode"
+					},
+					"annotationObject": {
+						"$ref": "https://schema.3sixty.global/json-ld/JsonLdNodeObject"
+					},
+					"verified": {
+						"type": "boolean",
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
+					},
+					"version": {
+						"type": "number",
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
+					},
+					"type": {
+						"const": "AuditableItemGraphVertex",
+						"description": "JSON-LD Type."
+					},
+					"aliasPatches": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphListPatch"
+					},
+					"resourcePatches": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphListPatch"
+					},
+					"edgePatches": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphListPatch"
+					}
+				},
+				"required": [
+					"@context"
+				]
+			},
+			"AuditableItemGraphUpdateRequest": {
+				"description": "The full vertex payload. Replaces annotation and active sub-lists; omitted collections are cleared.",
+				"type": "object",
+				"properties": {
+					"dateCreated": {
+						"type": "string",
+						"description": "The date/time of when the element was created."
+					},
+					"dateModified": {
+						"type": "string",
+						"description": "The date/time of when the element was modified."
+					},
+					"dateDeleted": {
+						"type": "string",
+						"description": "The date/time of when the element was deleted, as we never actually remove items."
+					},
+					"@context": {
+						"type": "array",
+						"prefixItems": [
+							{
+								"const": "https://schema.3sixty.global/aig/"
+							},
+							{
+								"const": "https://schema.3sixty.global/common/"
+							}
+						],
+						"items": {
+							"$ref": "https://schema.3sixty.global/json-ld/JsonLdContextDefinitionElement"
+						},
+						"minItems": 2,
+						"description": "JSON-LD Context."
+					},
+					"type": {
+						"const": "AuditableItemGraphVertex",
+						"description": "JSON-LD Type."
+					},
+					"organizationIdentity": {
+						"type": "string",
+						"description": "The identity of the organization which controls the vertex."
+					},
+					"auditMode": {
+						"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphAuditMode"
+					},
+					"annotationObject": {
+						"$ref": "https://schema.3sixty.global/json-ld/JsonLdNodeObject"
+					},
+					"aliases": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphAlias"
+						},
+						"description": "Alternative aliases that can be used to identify the vertex."
+					},
+					"resources": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphResource"
+						},
+						"description": "The resources attached to the vertex."
+					},
+					"edges": {
+						"type": "array",
+						"items": {
+							"$ref": "https://schema.3sixty.global/aig/AuditableItemGraphEdge"
+						},
+						"description": "Edges connected to the vertex."
+					},
+					"verified": {
+						"type": "boolean",
+						"description": "Is the vertex verified, will only be populated when verification is requested.\nAlways undefined when the vertex is in bypass mode."
+					},
+					"version": {
+						"type": "number",
+						"description": "The version of the vertex, populated only when getting a specific version.\nAlways undefined when the vertex is in bypass mode.\nMaps to https://schema.org/version."
+					}
+				},
+				"required": [
+					"@context",
+					"type"
+				]
+			},
+			"Error": {
+				"description": "Model to describe serialized error.",
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string",
+						"description": "The name for the error."
+					},
+					"message": {
+						"type": "string",
+						"description": "The message for the error as an i18n key."
+					},
+					"source": {
+						"type": "string",
+						"description": "The source of the error."
+					},
+					"properties": {
+						"type": "object",
+						"additionalProperties": {},
+						"description": "Any additional information for the error."
+					},
+					"stack": {
+						"type": "string",
+						"description": "The stack trace for the error."
+					},
+					"cause": {
+						"$ref": "#/components/schemas/Error"
+					}
+				},
+				"required": [
+					"name",
+					"message"
+				]
+			},
+			"SortDirection": {
+				"description": "The sort directions.",
+				"anyOf": [
+					{
+						"const": "asc",
+						"description": "Ascending."
+					},
+					{
+						"const": "desc",
+						"description": "Descending."
+					}
+				]
+			},
+			"VerifyDepth": {
+				"description": "How deep to verify the signatures.",
+				"anyOf": [
+					{
+						"const": "none",
+						"description": "Do not verify any signatures."
+					},
+					{
+						"const": "current",
+						"description": "Verify only the most recent signature."
+					},
+					{
+						"const": "all",
+						"description": "Verify all the signatures."
+					}
+				]
+			}
+		},
+		"securitySchemes": {
+			"jwtBearerAuthScheme": {
+				"type": "http",
+				"scheme": "bearer",
+				"bearerFormat": "JWT"
+			}
+		}
+	}
+}