@twin.org/node 0.9.2-next.1 → 0.9.2-next.11

package/docs/open-api/spec.json

@@ -153,11 +153,13 @@
 											"components": [
 												{
 													"source": "Database",
-													"status": "ok"
+													"status": "ok",
+													"category": "connectivity"
 												},
 												{
 													"source": "Storage",
-													"status": "ok"
+													"status": "ok",
+													"category": "connectivity"
 												}
 											]
 										}
@@ -170,11 +172,13 @@
 												{
 													"source": "Database",
 													"status": "warning",
-													"description": "slowRunning"
+													"description": "slowRunning",
+													"category": "connectivity"
 												},
 												{
 													"source": "Storage",
-													"status": "ok"
+													"status": "ok",
+													"category": "connectivity"
 												}
 											]
 										}
@@ -186,12 +190,14 @@
 											"components": [
 												{
 													"source": "Database",
-													"status": "ok"
+													"status": "ok",
+													"category": "connectivity"
 												},
 												{
 													"source": "Storage",
 													"status": "error",
-													"description": "storageFull"
+													"description": "storageFull",
+													"category": "connectivity"
 												}
 											]
 										}
@@ -2384,6 +2390,15 @@
 						},
 						"style": "simple",
 						"example": "did:iota:tst:0xe3088ba9aa8c28e1d139708a14e8c0fdff11ee8223baac4aa5bcf3321e4bfc6a"
+					},
+					{
+						"name": "removeKeys",
+						"description": "Also remove any associated private keys from the vault.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
 					}
 				],
 				"security": [
@@ -2724,6 +2739,15 @@
 						},
 						"style": "simple",
 						"example": "my-assertion"
+					},
+					{
+						"name": "removeKeys",
+						"description": "Also remove any associated private key from the vault.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
 					}
 				],
 				"security": [
@@ -5061,6 +5085,463 @@
 				}
 			}
 		},
+		"/identity/profile/{userIdentity}": {
+			"get": {
+				"operationId": "identityProfileAdminGet",
+				"summary": "Get the identity profile properties of another user",
+				"tags": [
+					"Identity Profile"
+				],
+				"parameters": [
+					{
+						"name": "userIdentity",
+						"description": "The identity of the user whose profile is to be retrieved.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "did:iota:tst:0xc57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
+					},
+					{
+						"name": "publicPropertyNames",
+						"description": "The public properties to get for the profile, defaults to all, should be a comma separated list.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "name,jobTitle"
+					},
+					{
+						"name": "privatePropertyNames",
+						"description": "The private properties to get for the profile, defaults to all, should be a comma separated list.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to get an identity details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityProfileGetResponse"
+								},
+								"examples": {
+									"identityProfileAdminGetResponseExample": {
+										"value": {
+											"identity": "did:iota:tst:0xc57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+											"publicProfile": {
+												"@context": "https://schema.org",
+												"@type": "Person",
+												"jobTitle": "Professor",
+												"name": "Jane Doe"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"403": {
+						"description": "The operation that you tried to perform is not possible, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "ForbiddenError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"404": {
+						"description": "The resource you tried to access does not exist, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/NotFoundResponse"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "NotFoundError",
+											"message": "errorMessage",
+											"properties": {
+												"notFoundId": "1"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"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": "identityProfileAdminUpdate",
+				"summary": "Update the identity profile properties of another user",
+				"tags": [
+					"Identity Profile"
+				],
+				"parameters": [
+					{
+						"name": "userIdentity",
+						"description": "The identity of the user whose profile is to be updated.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "did:iota:tst:0xc57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Request to update the profile of another user as an admin.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/IdentityProfileAdminUpdateRequest"
+							},
+							"examples": {
+								"identityProfileAdminUpdateRequestExample": {
+									"value": {
+										"publicProfile": {
+											"@context": "https://schema.org",
+											"@type": "Person",
+											"jobTitle": "Professor",
+											"name": "Jane Doe"
+										},
+										"privateProfile": {
+											"@context": "https://schema.org",
+											"@type": "Person",
+											"telephone": "(425) 123-4567",
+											"url": "http://www.janedoe.com"
+										}
+									}
+								}
+							}
+						}
+					}
+				},
+				"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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"403": {
+						"description": "The operation that you tried to perform is not possible, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "ForbiddenError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"404": {
+						"description": "The resource you tried to access does not exist, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/NotFoundResponse"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "NotFoundError",
+											"message": "errorMessage",
+											"properties": {
+												"notFoundId": "1"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
+			"delete": {
+				"operationId": "identityProfileAdminRemove",
+				"summary": "Remove the identity profile of another user",
+				"tags": [
+					"Identity Profile"
+				],
+				"parameters": [
+					{
+						"name": "userIdentity",
+						"description": "The identity of the user whose profile is to be removed.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "did:iota:tst:0xc57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
+					}
+				],
+				"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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"403": {
+						"description": "The operation that you tried to perform is not possible, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "ForbiddenError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"404": {
+						"description": "The resource you tried to access does not exist, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/NotFoundResponse"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "NotFoundError",
+											"message": "errorMessage",
+											"properties": {
+												"notFoundId": "1"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/identity/profile/{identity}/public": {
 			"get": {
 				"operationId": "identityProfileGetPublic",
@@ -5345,6 +5826,189 @@
 				}
 			}
 		},
+		"/identity/profile/admin/query": {
+			"get": {
+				"operationId": "identitiesProfileAdminList",
+				"summary": "Get the list of profile data for identities including private properties",
+				"tags": [
+					"Identity Profile"
+				],
+				"parameters": [
+					{
+						"name": "publicFilters",
+						"description": "The public filters to apply to the list, comma separated list with colon between key and value for each pair e.g. prop1:value1,prop2:value2.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "privateFilters",
+						"description": "The private filters to apply to the list, comma separated list with colon between key and value for each pair e.g. prop1:value1,prop2:value2.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "publicPropertyNames",
+						"description": "The public properties to get for the profile, defaults to all, should be a comma separated list.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "privatePropertyNames",
+						"description": "The private properties to get for the profile, defaults to none, should be a comma separated list.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "cursor",
+						"description": "The cursor for paged requests.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "limit",
+						"description": "Number of items to return.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to get an admin list of identities including private profile data.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityProfileAdminListResponse"
+								},
+								"examples": {
+									"identitiesProfileAdminListResponseExample": {
+										"value": {
+											"items": [
+												{
+													"identity": "did:iota:tst:0xc57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+													"publicProfile": {
+														"@context": "https://schema.org",
+														"@type": "Person",
+														"jobTitle": "Professor",
+														"name": "Jane Doe"
+													},
+													"privateProfile": {
+														"@context": "https://schema.org",
+														"@type": "Person",
+														"telephone": "(425) 123-4567"
+													}
+												}
+											],
+											"cursor": "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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"403": {
+						"description": "The operation that you tried to perform is not possible, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "ForbiddenError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/blob-storage": {
 			"post": {
 				"operationId": "blobStorageCreate",
@@ -12506,7 +13170,7 @@
 					}
 				],
 				"requestBody": {
-					"description": "Update an auditable item graph vertex (PUT — full replacement of vertex state).",
+					"description": "Update an auditable item graph vertex (PUT - full replacement of vertex state).",
 					"required": true,
 					"content": {
 						"application/json": {
@@ -12688,7 +13352,7 @@
 					}
 				],
 				"requestBody": {
-					"description": "Partially update an auditable item graph vertex (PATCH — explicit list patches).",
+					"description": "Partially update an auditable item graph vertex (PATCH - explicit list patches).",
 					"required": true,
 					"content": {
 						"application/json": {
@@ -17233,7 +17897,8 @@
 													"version": "2025-1",
 													"path": "/dataspace-control-plane/2025-1",
 													"binding": "HTTPS",
-													"serviceId": "twin-connector"
+													"identifierType": "did:iota",
+													"serviceId": "iota/twin.org/dspace-connector"
 												}
 											]
 										}
@@ -17999,7 +18664,7 @@
 					}
 				],
 				"requestBody": {
-					"description": "API request to register an app dataset.\n\nThe owning `tenantId` is captured automatically from the request's tenant\ncontext — callers do not supply it.",
+					"description": "API request to register an app dataset.\n\nThe owning `tenantId` is captured automatically from the request's tenant\ncontext - callers do not supply it.",
 					"required": true,
 					"content": {
 						"application/json": {
@@ -18726,6 +19391,15 @@
 							"type": "string"
 						},
 						"example": "optional-pagination-cursor"
+					},
+					{
+						"name": "properties",
+						"description": "Comma-separated list of policy property names to include in the response.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
 					}
 				],
 				"security": [
@@ -22478,9 +23152,15 @@
 						"type": "string",
 						"description": "The description of the component as an i18n key."
 					},
+					"category": {
+						"$ref": "#/components/schemas/HealthCategory"
+					},
 					"status": {
 						"$ref": "#/components/schemas/HealthStatus"
 					},
+					"error": {
+						"$ref": "#/components/schemas/Error"
+					},
 					"message": {
 						"type": "string",
 						"description": "The message for the status if there are further details to provide as an i18n key."
@@ -22503,6 +23183,19 @@
 					"status"
 				]
 			},
+			"HealthCategory": {
+				"description": "The category of a health check.",
+				"anyOf": [
+					{
+						"const": "connectivity",
+						"description": "Connectivity health check for infrastructure connectors."
+					},
+					{
+						"const": "application",
+						"description": "Application health check for domain services."
+					}
+				]
+			},
 			"HealthStatus": {
 				"description": "The health status of the component.",
 				"anyOf": [
@@ -22543,6 +23236,47 @@
 				},
 				"description": "The data for the request."
 			},
+			"IdentityProfileAdminListResponse": {
+				"type": "object",
+				"properties": {
+					"items": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"identity": {
+									"type": "string",
+									"description": "The identity."
+								}
+							},
+							"required": [
+								"identity"
+							]
+						},
+						"description": "The identities."
+					},
+					"cursor": {
+						"type": "string",
+						"description": "An optional cursor, when defined can be used to call find to get more entities."
+					}
+				},
+				"required": [
+					"items"
+				],
+				"description": "The response payload."
+			},
+			"IdentityProfileAdminUpdateRequest": {
+				"type": "object",
+				"properties": {
+					"publicProfile": {
+						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
+					},
+					"privateProfile": {
+						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
+					}
+				},
+				"description": "The data for the request."
+			},
 			"IdentityProfileCreateRequest": {
 				"type": "object",
 				"properties": {
@@ -23562,11 +24296,11 @@
 				"properties": {
 					"dateCreated": {
 						"type": "string",
-						"description": "schema.org dateCreated — ISO 8601 date-time set by PAP on create."
+						"description": "schema.org dateCreated - ISO 8601 date-time set by PAP on create."
 					},
 					"dateModified": {
 						"type": "string",
-						"description": "schema.org dateModified — ISO 8601 date-time set by PAP on create and update."
+						"description": "schema.org dateModified - ISO 8601 date-time set by PAP on create and update."
 					}
 				}
 			},