@twin.org/node 0.0.3-next.34 → 0.0.3-next.35

package/docs/open-api/spec.json

@@ -111,6 +111,10 @@
 			"name": "Transfer Process",
 			"description": "DSP Transfer Process Protocol endpoints for initiating and managing data transfers."
 		},
+		{
+			"name": "Datasets",
+			"description": "Tenant-scoped CRUD over the datasets the Control Plane reads at start time to populate the federated catalogue."
+		},
 		{
 			"name": "Policy Administration Point",
 			"description": "Endpoints for managing ODRL policies in the Policy Administration Point"
@@ -147,11 +151,11 @@
 											"status": "ok",
 											"components": [
 												{
-													"name": "Database",
+													"source": "Database",
 													"status": "ok"
 												},
 												{
-													"name": "Storage",
+													"source": "Storage",
 													"status": "ok"
 												}
 											]
@@ -163,12 +167,12 @@
 											"status": "warning",
 											"components": [
 												{
-													"name": "Database",
+													"source": "Database",
 													"status": "warning",
 													"description": "slowRunning"
 												},
 												{
-													"name": "Storage",
+													"source": "Storage",
 													"status": "ok"
 												}
 											]
@@ -180,11 +184,11 @@
 											"status": "error",
 											"components": [
 												{
-													"name": "Database",
+													"source": "Database",
 													"status": "ok"
 												},
 												{
-													"name": "Storage",
+													"source": "Storage",
 													"status": "error",
 													"description": "storageFull"
 												}
@@ -4939,6 +4943,91 @@
 					}
 				}
 			},
+			"delete": {
+				"operationId": "blobStorageEmpty",
+				"summary": "Remove all entries from blob storage",
+				"tags": [
+					"Blob Storage"
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Request to remove all entries from blob storage.",
+					"required": true,
+					"content": {
+						"text/plain": {
+							"schema": {
+								"$ref": "https://schema.twindev.org/blob-storage/BlobStorageEmptyRequest"
+							}
+						}
+					}
+				},
+				"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
 			"get": {
 				"operationId": "blobStorageQuery",
 				"summary": "Query the items from blob storage",
@@ -16916,12 +17005,12 @@
 				}
 			}
 		},
-		"/rights-management/policy/admin": {
+		"/dataspace-control-plane/app-datasets": {
 			"post": {
-				"operationId": "papCreate",
-				"summary": "Create a policy",
+				"operationId": "datasetCreate",
+				"summary": "Register an app dataset for the calling tenant.",
 				"tags": [
-					"Policy Administration Point"
+					"Datasets"
 				],
 				"security": [
 					{
@@ -16929,24 +17018,24 @@
 					}
 				],
 				"requestBody": {
-					"description": "The request structure for creating a policy.",
+					"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": {
 							"schema": {
-								"$ref": "#/components/schemas/PapCreateRequest"
+								"$ref": "#/components/schemas/AppDatasetCreateRequest"
 							},
 							"examples": {
-								"papCreateRequestExample": {
+								"datasetCreateRequestExample": {
 									"value": {
-										"@context": "http://www.w3.org/ns/odrl.jsonld",
-										"@type": "Set",
-										"permission": [
-											{
-												"target": "http://example.com/asset/1",
-												"action": "use"
-											}
-										]
+										"appId": "https://twin.example.org/app1",
+										"dataset": {
+											"@context": "https://w3id.org/dspace/2025/1/context.jsonld",
+											"@type": "Dataset",
+											"@id": "https://twin.example.org/data-service-1",
+											"hasPolicy": [],
+											"distribution": []
+										}
 									}
 								}
 							}
@@ -16954,14 +17043,21 @@
 					}
 				},
 				"responses": {
-					"201": {
-						"description": "The rest request ended in created response.",
+					"200": {
+						"description": "API response from registering an app dataset.",
+						"content": {
+							"text/plain": {
+								"schema": {
+									"$ref": "#/components/schemas/AppDatasetCreateResponse"
+								}
+							}
+						},
 						"headers": {
 							"location": {
 								"schema": {
 									"type": "string"
 								},
-								"description": "e.g. urn:rights-management:abc123def456"
+								"description": "e.g. https://twin.example.org/data-service-1"
 							}
 						}
 					},
@@ -17025,51 +17121,15 @@
 				}
 			},
 			"get": {
-				"operationId": "papQuery",
-				"summary": "Query policies",
+				"operationId": "datasetList",
+				"summary": "List the app datasets owned by the calling tenant.",
 				"tags": [
-					"Policy Administration Point"
+					"Datasets"
 				],
 				"parameters": [
 					{
-						"name": "assigner",
-						"description": "The assigner to filter by.",
-						"in": "query",
-						"required": false,
-						"schema": {
-							"type": "string"
-						}
-					},
-					{
-						"name": "assignee",
-						"description": "The assignee to filter by.",
-						"in": "query",
-						"required": false,
-						"schema": {
-							"type": "string"
-						}
-					},
-					{
-						"name": "action",
-						"description": "The action to filter by.",
-						"in": "query",
-						"required": false,
-						"schema": {
-							"type": "string"
-						}
-					},
-					{
-						"name": "target",
-						"description": "The target to filter by.",
-						"in": "query",
-						"required": false,
-						"schema": {
-							"type": "string"
-						}
-					},
-					{
-						"name": "conditions",
-						"description": "The condition for the query.",
+						"name": "cursor",
+						"description": "Cursor returned from a previous list call to fetch the next page.",
 						"in": "query",
 						"required": false,
 						"schema": {
@@ -17078,22 +17138,12 @@
 					},
 					{
 						"name": "limit",
-						"description": "Limit the number of entities to return.",
+						"description": "Maximum number of entries to return (string-encoded; parsed on the server).",
 						"in": "query",
 						"required": false,
 						"schema": {
 							"type": "string"
 						}
-					},
-					{
-						"name": "cursor",
-						"description": "The cursor to get next chunk of data, returned in previous response.",
-						"in": "query",
-						"required": false,
-						"schema": {
-							"type": "string"
-						},
-						"example": "optional-pagination-cursor"
 					}
 				],
 				"security": [
@@ -17103,28 +17153,11 @@
 				],
 				"responses": {
 					"200": {
-						"description": "The response structure for querying policies.",
+						"description": "API response listing the app datasets owned by the calling tenant.",
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/PapQueryResponse"
-								},
-								"examples": {
-									"papQueryResponseExample": {
-										"value": [
-											{
-												"@context": "http://www.w3.org/ns/odrl.jsonld",
-												"@type": "Set",
-												"@id": "urn:rights-management:abc123def456",
-												"permission": [
-													{
-														"target": "http://example.com/asset/1",
-														"action": "use"
-													}
-												]
-											}
-										]
-									}
+									"$ref": "#/components/schemas/AppDatasetListResponse"
 								}
 							}
 						}
@@ -17189,24 +17222,24 @@
 				}
 			}
 		},
-		"/rights-management/policy/admin/{id}": {
-			"put": {
-				"operationId": "papUpdate",
-				"summary": "Update a policy",
+		"/dataspace-control-plane/app-datasets/{id}": {
+			"get": {
+				"operationId": "datasetGet",
+				"summary": "Retrieve an app dataset owned by the calling tenant.",
 				"tags": [
-					"Policy Administration Point"
+					"Datasets"
 				],
 				"parameters": [
 					{
 						"name": "id",
-						"description": "The ID of the policy to update.",
+						"description": "The stored app dataset id (entity primary key).",
 						"in": "path",
 						"required": true,
 						"schema": {
 							"type": "string"
 						},
 						"style": "simple",
-						"example": "urn:rights-management:abc123def456"
+						"example": "dataspace-app-dataset-1"
 					}
 				],
 				"security": [
@@ -17214,35 +17247,16 @@
 						"jwtBearerAuthScheme": []
 					}
 				],
-				"requestBody": {
-					"description": "The request structure for updating a policy.",
-					"required": true,
-					"content": {
-						"application/json": {
-							"schema": {
-								"$ref": "#/components/schemas/RightsManagementPolicy"
-							},
-							"examples": {
-								"papUpdateRequestExample": {
-									"value": {
-										"@context": "http://www.w3.org/ns/odrl.jsonld",
-										"@type": "Set",
-										"@id": "urn:rights-management:abc123def456",
-										"permission": [
-											{
-												"target": "http://example.com/asset/2",
-												"action": "read"
-											}
-										]
-									}
+				"responses": {
+					"200": {
+						"description": "API response for a single stored app dataset record.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/DataspaceAppDataset"
 								}
 							}
 						}
-					}
-				},
-				"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.",
@@ -17303,23 +17317,23 @@
 					}
 				}
 			},
-			"get": {
-				"operationId": "papGet",
-				"summary": "Get a policy",
+			"put": {
+				"operationId": "datasetUpdate",
+				"summary": "Update an app dataset owned by the calling tenant.",
 				"tags": [
-					"Policy Administration Point"
+					"Datasets"
 				],
 				"parameters": [
 					{
 						"name": "id",
-						"description": "The ID of the policy to get.",
+						"description": "The stored app dataset id.",
 						"in": "path",
 						"required": true,
 						"schema": {
 							"type": "string"
 						},
 						"style": "simple",
-						"example": "urn:rights-management:abc123def456"
+						"example": "dataspace-app-dataset-1"
 					}
 				],
 				"security": [
@@ -17327,19 +17341,647 @@
 						"jwtBearerAuthScheme": []
 					}
 				],
+				"requestBody": {
+					"description": "API request to update an existing app dataset record.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/AppDatasetUpdateRequest"
+							},
+							"examples": {
+								"datasetUpdateRequestExample": {
+									"value": {
+										"appId": "https://twin.example.org/app1",
+										"dataset": {
+											"@context": "https://w3id.org/dspace/2025/1/context.jsonld",
+											"@type": "Dataset",
+											"hasPolicy": [],
+											"distribution": []
+										}
+									}
+								}
+							}
+						}
+					}
+				},
 				"responses": {
-					"200": {
-						"description": "The response structure for getting a policy.",
+					"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/RightsManagementPolicy"
+									"$ref": "#/components/schemas/Error"
 								},
 								"examples": {
-									"papGetResponseExample": {
+									"exampleResponse": {
 										"value": {
-											"@context": "http://www.w3.org/ns/odrl.jsonld",
-											"@type": "Set",
+											"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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"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": "datasetDelete",
+				"summary": "Delete an app dataset owned by the calling tenant.",
+				"tags": [
+					"Datasets"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The stored dataset id.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "dataspace-app-dataset-1"
+					}
+				],
+				"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"
+										}
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/rights-management/policy/admin": {
+			"post": {
+				"operationId": "papCreate",
+				"summary": "Create a policy",
+				"tags": [
+					"Policy Administration Point"
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "The request structure for creating a policy.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/PapCreateRequest"
+							},
+							"examples": {
+								"papCreateRequestExample": {
+									"value": {
+										"@context": "http://www.w3.org/ns/odrl.jsonld",
+										"@type": "Set",
+										"permission": [
+											{
+												"target": "http://example.com/asset/1",
+												"action": "use"
+											}
+										]
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"201": {
+						"description": "The rest request ended in created response.",
+						"headers": {
+							"location": {
+								"schema": {
+									"type": "string"
+								},
+								"description": "e.g. urn:rights-management:abc123def456"
+							}
+						}
+					},
+					"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": "papQuery",
+				"summary": "Query policies",
+				"tags": [
+					"Policy Administration Point"
+				],
+				"parameters": [
+					{
+						"name": "assigner",
+						"description": "The assigner to filter by.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "assignee",
+						"description": "The assignee to filter by.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "action",
+						"description": "The action to filter by.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "target",
+						"description": "The target to filter by.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "conditions",
+						"description": "The condition for the query.",
+						"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": "cursor",
+						"description": "The cursor to get next chunk of data, returned in previous response.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "optional-pagination-cursor"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "The response structure for querying policies.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/PapQueryResponse"
+								},
+								"examples": {
+									"papQueryResponseExample": {
+										"value": [
+											{
+												"@context": "http://www.w3.org/ns/odrl.jsonld",
+												"@type": "Set",
+												"@id": "urn:rights-management:abc123def456",
+												"permission": [
+													{
+														"target": "http://example.com/asset/1",
+														"action": "use"
+													}
+												]
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/rights-management/policy/admin/{id}": {
+			"put": {
+				"operationId": "papUpdate",
+				"summary": "Update a policy",
+				"tags": [
+					"Policy Administration Point"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The ID of the policy to update.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "urn:rights-management:abc123def456"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "The request structure for updating a policy.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/RightsManagementPolicy"
+							},
+							"examples": {
+								"papUpdateRequestExample": {
+									"value": {
+										"@context": "http://www.w3.org/ns/odrl.jsonld",
+										"@type": "Set",
+										"@id": "urn:rights-management:abc123def456",
+										"permission": [
+											{
+												"target": "http://example.com/asset/2",
+												"action": "read"
+											}
+										]
+									}
+								}
+							}
+						}
+					}
+				},
+				"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"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			},
+			"get": {
+				"operationId": "papGet",
+				"summary": "Get a policy",
+				"tags": [
+					"Policy Administration Point"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The ID of the policy to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "urn:rights-management:abc123def456"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "The response structure for getting a policy.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/RightsManagementPolicy"
+								},
+								"examples": {
+									"papGetResponseExample": {
+										"value": {
+											"@context": "http://www.w3.org/ns/odrl.jsonld",
+											"@type": "Set",
 											"@id": "urn:rights-management:abc123def456",
 											"permission": [
 												{
@@ -19544,6 +20186,65 @@
 					}
 				}
 			},
+			"AppDatasetCreateRequest": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"description": "Optional explicit id for the stored dataset record. If omitted, the\nControl Plane derives the id from `dataset[\"@id\"]` if present, or\ngenerates a UUID otherwise. The resolved id is returned via the\n`Location` response header."
+					},
+					"appId": {
+						"type": "string",
+						"description": "The dataspace app this dataset belongs to. Matches the app's\nregistered name in `DataspaceAppFactory` (typically the app's URI)."
+					},
+					"dataset": {
+						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataset"
+					}
+				},
+				"required": [
+					"appId",
+					"dataset"
+				],
+				"description": "The body of the request."
+			},
+			"AppDatasetCreateResponse": {},
+			"AppDatasetListResponse": {
+				"type": "object",
+				"properties": {
+					"entities": {
+						"type": "array",
+						"items": {
+							"$ref": "#/components/schemas/DataspaceAppDataset"
+						},
+						"description": "The stored datasets."
+					},
+					"cursor": {
+						"type": "string",
+						"description": "Cursor to fetch the next page if more entries exist."
+					}
+				},
+				"required": [
+					"entities"
+				],
+				"description": "The body of the response."
+			},
+			"AppDatasetUpdateRequest": {
+				"type": "object",
+				"properties": {
+					"appId": {
+						"type": "string",
+						"description": "The dataspace app this dataset belongs to. May change appId on\nupdate if the tenant wants to retarget the dataset."
+					},
+					"dataset": {
+						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataset"
+					}
+				},
+				"required": [
+					"appId",
+					"dataset"
+				],
+				"description": "The body of the request."
+			},
 			"AttestationCreateRequest": {
 				"type": "object",
 				"properties": {
@@ -20303,6 +21004,38 @@
 				],
 				"description": "The data to be used in the store."
 			},
+			"DataspaceAppDataset": {
+				"description": "Stored dataset record returned by the Control Plane's dataset CRUD surface.",
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"description": "The stored dataset id (matches the dataset's JSON-LD `@id`)."
+					},
+					"appId": {
+						"type": "string",
+						"description": "The dataspace app this dataset belongs to."
+					},
+					"dataset": {
+						"$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataset"
+					},
+					"dateCreated": {
+						"type": "string",
+						"description": "Creation timestamp (ISO string)."
+					},
+					"dateModified": {
+						"type": "string",
+						"description": "Last-modified timestamp (ISO string)."
+					}
+				},
+				"required": [
+					"id",
+					"appId",
+					"dataset",
+					"dateCreated",
+					"dateModified"
+				]
+			},
 			"DocumentManagementCreateRequest": {
 				"type": "object",
 				"properties": {
@@ -20483,33 +21216,36 @@
 				"description": "Provides health information for a component.",
 				"type": "object",
 				"properties": {
-					"name": {
+					"source": {
 						"type": "string",
-						"description": "The name of the component."
+						"description": "The source of the health information."
 					},
 					"description": {
 						"type": "string",
 						"description": "The description of the component as an i18n key."
 					},
-					"isChild": {
-						"type": "boolean",
-						"description": "Whether this entry is a child of another entry, the parent entry will report the overall status of the component."
-					},
 					"status": {
 						"$ref": "#/components/schemas/HealthStatus"
 					},
-					"details": {
+					"message": {
 						"type": "string",
-						"description": "The details for the status if there are further details to provide as an i18n key."
+						"description": "The message for the status if there are further details to provide as an i18n key."
 					},
-					"properties": {
+					"data": {
 						"type": "object",
 						"additionalProperties": {},
-						"description": "Properties to substitute in the i18n key for the details."
+						"description": "Data to substitute in the i18n key for the message."
+					},
+					"grouped": {
+						"type": "array",
+						"items": {
+							"$ref": "#/components/schemas/Health"
+						},
+						"description": "The grouped child components, if any."
 					}
 				},
 				"required": [
-					"name",
+					"source",
 					"status"
 				]
 			},
@@ -22186,6 +22922,10 @@
 					"unit": {
 						"type": "string",
 						"description": "The unit the metric describes."
+					},
+					"maxHistory": {
+						"type": "number",
+						"description": "The maximum number of values to retain; oldest are trimmed on each addMetricValue call.\nUnlimited when absent."
 					}
 				},
 				"required": [