{
  "openapi": "3.1.0",
  "info": {
    "title": "Kaphera Cloud API",
    "description": "Public-facing HTTP API for managing resources on the Kaphera Cloud platform.",
    "license": {
      "name": ""
    },
    "version": "0.1.0"
  },
  "paths": {
    "/healthz": {
      "get": {
        "tags": [
          "Platform"
        ],
        "summary": "Health check",
        "operationId": "healthz",
        "responses": {
          "200": {
            "description": "Server is healthy",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "tags": [
          "Platform"
        ],
        "summary": "OpenAPI specification",
        "operationId": "openapi_json",
        "responses": {
          "200": {
            "description": "The OpenAPI specification of this deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/v1/api-keys/exchange": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Exchange an API key for a short-lived access token",
        "description": "RFC 8693 token exchange. Exchange when the cached token's remaining life drops below 20% (the kubelet/GitHub-Octokit rule); a simple client may just exchange per TTL.",
        "operationId": "exchange",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExchangeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Token issued",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExchangeResponse"
                }
              }
            }
          },
          "400": {
            "description": "Malformed body, unsupported grant_type or subject_token_type"
          },
          "401": {
            "description": "Invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/v1/api-keys/self": {
      "get": {
        "tags": [
          "API Keys"
        ],
        "summary": "View the calling API key",
        "operationId": "self_view",
        "responses": {
          "200": {
            "description": "The calling API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKey"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an API key caller"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "API Keys"
        ],
        "summary": "Revoke the calling API key",
        "operationId": "self_revoke",
        "responses": {
          "204": {
            "description": "API key revoked"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an API key caller"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/api-keys/self/rotate": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Rotate the calling API key's secret",
        "operationId": "self_rotate",
        "responses": {
          "200": {
            "description": "The API key with a fresh secret",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyCreated"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an API key caller"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/dataspace-discovery": {
      "get": {
        "tags": [
          "Dataspace Discovery"
        ],
        "summary": "List the public dataspace directory",
        "operationId": "discover",
        "parameters": [
          {
            "name": "stage",
            "in": "query",
            "description": "Stage filter: `current` (default), `old`, or `next` (previewable drafts)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of public dataspace discovery entries",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_DataspaceDiscoveryEntry"
                }
              }
            }
          },
          "400": {
            "description": "Invalid stage filter, limit, or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations": {
      "get": {
        "tags": [
          "Organisations"
        ],
        "summary": "List the caller's organisations",
        "operationId": "list_organisations",
        "responses": {
          "200": {
            "description": "The caller's organisations",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrganisationSummary"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Organisations"
        ],
        "summary": "Register an organisation",
        "operationId": "register_organisation",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrganisationRegistration"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Organisation registered",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Organisation"
                }
              }
            }
          },
          "400": {
            "description": "Invalid slug or display name"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "API keys cannot register organisations"
          },
          "409": {
            "description": "Slug already taken"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}": {
      "get": {
        "tags": [
          "Organisations"
        ],
        "summary": "Get an organisation",
        "operationId": "get_organisation",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The organisation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Organisation"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Organisation not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Organisations"
        ],
        "summary": "Delete an organisation",
        "operationId": "delete_organisation",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Organisation deleted"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "409": {
            "description": "Organisation still owns dataspaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/activity-log": {
      "get": {
        "tags": [
          "Activity Log"
        ],
        "summary": "List the organisation's activity log",
        "operationId": "list_activity_log",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of activity log events",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_ActivityLogEvent"
                }
              }
            }
          },
          "400": {
            "description": "Invalid limit or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/api-keys": {
      "get": {
        "tags": [
          "API Keys"
        ],
        "summary": "List the organisation's API keys",
        "operationId": "list",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of API keys",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_ApiKey"
                }
              }
            }
          },
          "400": {
            "description": "Invalid limit or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Create an API key",
        "operationId": "create",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApiKeyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "API key created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyCreated"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "409": {
            "description": "A live key with this name already exists"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/api-keys/{key_id}": {
      "get": {
        "tags": [
          "API Keys"
        ],
        "summary": "Get an API key",
        "operationId": "get",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "key_id",
            "in": "path",
            "description": "API key ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKey"
                }
              }
            }
          },
          "400": {
            "description": "Invalid api key id"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "API Keys"
        ],
        "summary": "Revoke an API key",
        "operationId": "revoke",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "key_id",
            "in": "path",
            "description": "API key ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "API key revoked"
          },
          "400": {
            "description": "Invalid api key id"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/api-keys/{key_id}/disable": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Disable an API key",
        "operationId": "disable",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "key_id",
            "in": "path",
            "description": "API key ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The updated API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKey"
                }
              }
            }
          },
          "400": {
            "description": "Invalid api key id"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/api-keys/{key_id}/enable": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Enable an API key",
        "operationId": "enable",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "key_id",
            "in": "path",
            "description": "API key ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The updated API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKey"
                }
              }
            }
          },
          "400": {
            "description": "Invalid api key id"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/api-keys/{key_id}/rotate": {
      "post": {
        "tags": [
          "API Keys"
        ],
        "summary": "Rotate an API key's secret",
        "operationId": "rotate",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "key_id",
            "in": "path",
            "description": "API key ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The API key with a fresh secret",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyCreated"
                }
              }
            }
          },
          "400": {
            "description": "Invalid api key id"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "404": {
            "description": "API key not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces": {
      "get": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "List the organisation's dataspaces",
        "operationId": "list_dataspaces",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of the organisation's dataspaces",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_Dataspace"
                }
              }
            }
          },
          "400": {
            "description": "Invalid limit or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Register a dataspace",
        "operationId": "create_dataspace",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DataspaceRegistration"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Dataspace registered",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dataspace"
                }
              }
            }
          },
          "400": {
            "description": "Invalid slug, display name, or description"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "409": {
            "description": "Slug already taken"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}": {
      "get": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Get a dataspace",
        "operationId": "get_dataspace",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The dataspace",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dataspace"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Delete a dataspace",
        "operationId": "delete_dataspace",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Dataspace deleted"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace not found"
          },
          "409": {
            "description": "Dataspace still has versions"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions": {
      "get": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "List the dataspace's versions",
        "operationId": "list_versions",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of the dataspace's versions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_DataspaceVersion"
                }
              }
            }
          },
          "400": {
            "description": "Invalid limit or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Register a dataspace version",
        "operationId": "create_version",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DataspaceVersionRegistration"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Dataspace version registered",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceVersion"
                }
              }
            }
          },
          "400": {
            "description": "Invalid slug"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace not found"
          },
          "409": {
            "description": "Slug already taken"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}": {
      "delete": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Delete a dataspace version",
        "operationId": "delete_version",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Dataspace version deleted"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be deleted"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/lts": {
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Set a dataspace version's LTS flag",
        "operationId": "set_lts",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DataspaceVersionLtsUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The updated version",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceVersion"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/preview": {
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Mark a dataspace version as preview",
        "operationId": "set_preview",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The updated version",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceVersion"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be previewed"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/profiles": {
      "get": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "List a version's profiles",
        "operationId": "list_profiles",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of items to return (1-200, default 50).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50,
              "maximum": 200,
              "minimum": 1
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "Opaque cursor received from a previous response's `nextCursor`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of the version's profiles",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Page_DataspaceProfile"
                }
              }
            }
          },
          "400": {
            "description": "Invalid limit or cursor"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Register a dataspace profile",
        "operationId": "create_profile",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileDocument"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Dataspace profile registered",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceProfile"
                }
              }
            }
          },
          "400": {
            "description": "Invalid profile document"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be modified, or the profile already exists"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/profiles/{profile_slug}": {
      "get": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Get a dataspace profile",
        "operationId": "get_profile",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "profile_slug",
            "in": "path",
            "description": "Profile slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The dataspace profile",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceProfile"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace, version, or profile not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Update a dataspace profile",
        "operationId": "update_profile",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "profile_slug",
            "in": "path",
            "description": "Profile slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProfileDocument"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The updated profile",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceProfile"
                }
              }
            }
          },
          "400": {
            "description": "Invalid profile document"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace, version, or profile not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be modified, or identity fields cannot be changed"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Delete a dataspace profile",
        "operationId": "delete_profile",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "profile_slug",
            "in": "path",
            "description": "Profile slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Dataspace profile deleted"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace, version, or profile not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be deleted"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/promote": {
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Promote a dataspace version to current",
        "operationId": "promote_version",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The promoted version",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceVersion"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          },
          "409": {
            "description": "Only drafts (stage=next) can be promoted"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/versions/{version_slug}/withdraw-preview": {
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Withdraw a dataspace version's preview",
        "operationId": "withdraw_preview",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version_slug",
            "in": "path",
            "description": "Version slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The updated version",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataspaceVersion"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace or version not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/dataspaces/{dataspace_slug}/visibility": {
      "post": {
        "tags": [
          "Dataspaces"
        ],
        "summary": "Set dataspace visibility",
        "operationId": "set_dataspace_visibility",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "dataspace_slug",
            "in": "path",
            "description": "Dataspace slug",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DataspaceVisibilityUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The updated dataspace",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dataspace"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Dataspace not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List credential authorities",
        "description": "Pass-through over the cluster API seam; authorities are cluster-wide estate deployments.",
        "operationId": "list_authorities",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Credential authorities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuthoritySummary"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List credential issuers under an authority",
        "description": "Pass-through over the cluster API seam; only the caller's organisation's issuers are returned.",
        "operationId": "list_issuers",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Credential issuers",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerView"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Authority not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Mint a credential issuer under an authority",
        "operationId": "create_issuer",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateIssuer"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Issuer minted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerView"
                }
              }
            }
          },
          "400": {
            "description": "Invalid displayName or description"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Authority not found"
          },
          "409": {
            "description": "Authority is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a credential issuer",
        "description": "Pass-through over the cluster API seam. The org check runs platform-side against the cluster-returned org: 404 when the issuer is absent, 403 when it belongs to another organisation.",
        "operationId": "get_issuer",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The credential issuer",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerView"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority or issuer not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/attestation-definitions": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List attestation definitions under a credential issuer",
        "operationId": "list_attestation_definitions",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Attestation definitions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AttestationDefinitionView"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Authority or issuer not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Mint an attestation definition under a credential issuer",
        "description": "Relayed verbatim over the cluster API seam after the platform-side org check. The definition id is minted platform-side as a UUID v4 and the fixed holder attestation body is sent upstream; the upstream 201 body is empty, so the view is synthesised from the sent values. An upstream 409 (definition already exists) is idempotent success.",
        "operationId": "create_attestation_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Attestation definition minted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AttestationDefinitionView"
                }
              }
            }
          },
          "400": {
            "description": "Upstream rejected the attestation definition"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority or issuer not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/attestation-definitions/{definition_id}": {
      "delete": {
        "tags": [
          "EDC"
        ],
        "summary": "Delete an attestation definition under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check. Upstream deletes attestations without checking credential definitions, so the platform refuses the delete with a 409 while any credential definition in the issuer's context still references the attestation (a credential-definition query with the attestations/contains criterion). The upstream DELETE is 404-when-absent, so a miss surfaces as the house 404; success is a 204 with an empty body.",
        "operationId": "delete_attestation_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "definition_id",
            "in": "path",
            "description": "Attestation definition ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Attestation definition deleted"
          },
          "400": {
            "description": "Definition id is malformed"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority, issuer, or attestation definition not found"
          },
          "409": {
            "description": "The attestation is still referenced by a credential definition, or the issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/credential-definitions": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List credential definitions under a credential issuer",
        "operationId": "list_credential_definitions",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Credential definitions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CredentialDefinitionView"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Authority, issuer, or attestation not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Mint a credential definition under a credential issuer",
        "description": "Relayed verbatim over the cluster API seam after the platform-side org check and the platform-side format/validity checks. The definition id is minted platform-side as a UUID v4; the upstream 201 body is empty, so the view is synthesised from the sent values. An upstream 409 (definition already exists) is idempotent success.",
        "operationId": "create_credential_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCredentialDefinition"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Credential definition minted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialDefinitionView"
                }
              }
            }
          },
          "400": {
            "description": "Invalid credential definition"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority or issuer not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/credential-definitions/{definition_id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a credential definition under a credential issuer",
        "description": "Relayed verbatim over the cluster API seam after the platform-side org check. An upstream 404 surfaces as the house 404.",
        "operationId": "get_credential_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "definition_id",
            "in": "path",
            "description": "Credential definition ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The credential definition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialDefinitionView"
                }
              }
            }
          },
          "400": {
            "description": "Definition id is malformed"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority, issuer, or credential definition not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "tags": [
          "EDC"
        ],
        "summary": "Update a credential definition under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check. Upstream PUT is a full-row replace on the collection path, so the current definition is fetched first and every omitted request field is backfilled from it — an absent field would otherwise wipe the stored value. The relayed body id is the PATH id, never client-supplied. The 200 carries the truthful post-update view from a re-GET; upstream answers the update itself with an empty 200 body.",
        "operationId": "update_credential_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "definition_id",
            "in": "path",
            "description": "Credential definition ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCredentialDefinition"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Credential definition updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialDefinitionView"
                }
              }
            }
          },
          "400": {
            "description": "Invalid credential definition"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority, issuer, or credential definition not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "summary": "Delete a credential definition under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check. The upstream DELETE is 404-when-absent rather than an idempotent no-op, so a miss surfaces as the house 404; success is a 204 with an empty body.",
        "operationId": "delete_credential_definition",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "definition_id",
            "in": "path",
            "description": "Credential definition ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Credential definition deleted"
          },
          "400": {
            "description": "Definition id is malformed"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority, issuer, or credential definition not found"
          },
          "409": {
            "description": "Issuer is not ready yet"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/did-contexts": {
      "put": {
        "tags": [
          "EDC"
        ],
        "summary": "Replace a credential issuer's DID context set",
        "description": "Relayed over the cluster API seam after the platform-side org check. The seam stamps the set onto the IssuingAuthority spec and the onboarding operator converges it onto the issuer's DID document (the W3C base context is always preserved). Clearing is not supported — the operator treats an empty set as nothing to manage — so an empty list is rejected before any seam traffic.",
        "operationId": "set_issuer_did_contexts",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetIssuerDidContexts"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The updated credential issuer",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerView"
                }
              }
            }
          },
          "400": {
            "description": "didContextUrls is empty or contains blank URLs"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Authority or issuer not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/holders": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List holders under a credential issuer",
        "description": "Proxy over the cluster API seam. The org check runs platform-side against the cluster-returned org: 404 when the issuer is absent, 403 when it belongs to another organisation — both before any proxy call.",
        "operationId": "list_holders",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of holders to return.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Number of holders to skip.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "sortField",
            "in": "query",
            "description": "Field to sort by (upstream holder field name).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sortOrder",
            "in": "query",
            "description": "Sort direction; one of ASC or DESC.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Holders",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Holder"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid sortOrder"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Create a holder under a credential issuer",
        "description": "Relayed verbatim over the cluster API seam after the platform-side org check. The holder id is minted platform-side as a UUID v7; the upstream 201 body is empty, so the §8.1 holder view is synthesised from the request.",
        "operationId": "create_holder",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateHolder"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Holder created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Holder"
                }
              }
            }
          },
          "400": {
            "description": "Malformed JSON body"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer not found"
          },
          "409": {
            "description": "Holder already exists"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/holders/{holder_id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a holder under a credential issuer",
        "description": "Proxy over the cluster API seam. The holder id is validated as a UUID and re-rendered canonically before any traffic; the org check runs platform-side against the cluster-returned org: 404 when the issuer is absent, 403 when it belongs to another organisation — both before any proxy call.",
        "operationId": "get_holder",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The holder",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Holder"
                }
              }
            }
          },
          "400": {
            "description": "Holder id is not a UUID"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or holder not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "tags": [
          "EDC"
        ],
        "summary": "Update a holder under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check. Upstream PUT is a full-row replace, so the current holder is fetched first and omitted request fields are backfilled from it; holderId and did are platform-supplied, never editable, and `anonymous` never round-trips — the upstream PUT resets it to false (D17). The 200 carries the truthful post-update view from a re-GET.",
        "operationId": "update_holder",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateHolder"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Holder updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Holder"
                }
              }
            }
          },
          "400": {
            "description": "Holder id is not a UUID or the body is malformed JSON"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or holder not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "summary": "Delete a holder under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check. The upstream DELETE is 404-when-absent rather than an upsert or an idempotent no-op, so a miss surfaces as the house 404; success is a 204 with an empty body.",
        "operationId": "delete_holder",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Holder deleted"
          },
          "400": {
            "description": "Holder id is not a UUID"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or holder not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/holders/{holder_id}/credentials": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List a holder's credentials under a credential issuer",
        "description": "Proxy over the cluster API seam. The holder is resolved through the seam first (404 when absent) and its DID drives the credential query — criterion `holderId = <DID>` (D12); status-list records, whose holderId is the issuer's own DID, are excluded. Query-spec fields are validated platform-side against the upstream allow-list before any seam traffic, because an unknown criterion field compiles to a silent empty result upstream. The org check runs platform-side against the cluster-returned org: 404 when the issuer is absent, 403 when it belongs to another organisation — both before any proxy call.",
        "operationId": "list_holder_credentials",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Maximum number of credentials to return.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Number of credentials to skip.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "sortField",
            "in": "query",
            "description": "Field to sort by (upstream credential resource field name).",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sortOrder",
            "in": "query",
            "description": "Sort direction; one of ASC or DESC.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The holder's credentials",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CredentialView"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Holder id is not a UUID, invalid sortOrder, or an unknown sort field"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or holder not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Offer credentials to a holder under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side org check and holder fetch (404 when absent). The upstream offer keys on the internal holder id — the platform-minted UUID read from the fetched holder record, never the DID — so holderId is platform-supplied and never accepted from the client; the request body carries only the credential definition ids and an optional offerReason, both relayed verbatim. Success is a 204 with an empty body; an upstream rejection (e.g. unknown credential definition ids) surfaces as the house validation error.",
        "operationId": "offer_credentials",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OfferCredentials"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Credentials offered"
          },
          "400": {
            "description": "Holder id is not a UUID, the body is malformed JSON, or the upstream rejects the offer"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or holder not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/holders/{holder_id}/credentials/{credential_id}/revoke": {
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Revoke a credential under a credential issuer",
        "description": "Relayed over the cluster API seam after the platform-side id validation and org check. The revoke carries no request body; success is a 204 with an empty body, and an unknown credential id upstream surfaces as the house 404. The revoke is activity-logged against the holder, with the canonical credential id in the metadata.",
        "operationId": "revoke_credential",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "credential_id",
            "in": "path",
            "description": "Credential ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Credential revoked"
          },
          "400": {
            "description": "Holder or credential id is not a UUID"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or credential not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/authorities/{authority}/issuers/{issuer}/holders/{holder_id}/credentials/{credential_id}/status": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a credential's status under a credential issuer",
        "description": "Proxy over the cluster API seam. Both ids are parsed and canonically re-rendered platform-side, and the org check runs platform-side against the cluster-returned org: 404 when the issuer is absent, 403 when it belongs to another organisation — both before any proxy call. The response mirrors the upstream status view verbatim, including a null reason.",
        "operationId": "get_credential_status",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "authority",
            "in": "path",
            "description": "Authority deployment name",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "issuer",
            "in": "path",
            "description": "Credential issuer ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_id",
            "in": "path",
            "description": "Holder ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "credential_id",
            "in": "path",
            "description": "Credential ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The credential's status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialStatusDto"
                }
              }
            }
          },
          "400": {
            "description": "Holder or credential id is not a UUID"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Issuer belongs to another organisation"
          },
          "404": {
            "description": "Issuer or credential not found"
          },
          "409": {
            "description": "Authority name is ambiguous across namespaces"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/connectors": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List shared connectors",
        "operationId": "list_connectors",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Shared connectors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ConnectorSummary"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/controlplane/{name}/{version}/participants/{participant_id}/assets/{id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "description": "Gets an asset with the given ID",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlplaneAsset"
                }
              }
            },
            "description": "The asset"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request was malformed, e.g. id was null"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiErrorDetail"
                  }
                }
              }
            },
            "description": "An asset with the given ID does not exist"
          },
          "401": {
            "description": "Platform-side house error before any relay traffic"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "dataspaces:read"
            ]
          }
        ],
        "operationId": "getAssetV5"
      }
    },
    "/v1/organisations/{organisation_id}/edc/controlplane/{name}/{version}/participants/{participant_id}/catalog/request": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Directly mapped to POST /v5beta/participants/{participantContextId}/catalog/request of the controlplane EDC component. Requires the dataspaces:read scope.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "default": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlplaneCatalog"
                }
              }
            },
            "description": "Gets contract offers (=catalog) of a single connector"
          },
          "401": {
            "description": "Platform-side house error before any relay traffic"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          }
        },
        "security": [
          {
            "bearer": [
              "dataspaces:read"
            ]
          }
        ],
        "operationId": "requestCatalogV5",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlplaneCatalogRequest"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/controlplane/{name}/{version}/participants/{participant_id}/contractdefinitions/{id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "description": "Gets an contract definition with the given ID",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ControlplaneContractDefinition"
                }
              }
            },
            "description": "The contract definition"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiError"
                  }
                }
              }
            },
            "description": "Request was malformed, e.g. id was null"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiError"
                  }
                }
              }
            },
            "description": "An contract agreement with the given ID does not exist"
          },
          "401": {
            "description": "Platform-side house error before any relay traffic"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "dataspaces:read"
            ]
          }
        ],
        "operationId": "getContractDefinitionV5"
      }
    },
    "/v1/organisations/{organisation_id}/edc/controlplane/{name}/{version}/participants/{participant_id}/profiles": {
      "put": {
        "tags": [
          "EDC"
        ],
        "description": "Associate Dataspace Profile contexts to a participant context.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The dataspace profile contexts was successfully associated to the participant context"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiError"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiError"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ControlplaneApiError"
                  }
                }
              }
            },
            "description": "A ParticipantContext with the given ID does not exist."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "identity:write"
            ]
          }
        ],
        "operationId": "associateProfiles",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ControlplaneAssociateDataspaceProfile"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List dataspace identities",
        "operationId": "list_identities",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dataspace identities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityView"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Create a dataspace identity",
        "operationId": "create_identity",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateIdentity"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Identity created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityView"
                }
              }
            }
          },
          "400": {
            "description": "Invalid displayName or description"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Specified connector not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a dataspace identity",
        "operationId": "get_identity",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The dataspace identity",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityView"
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "summary": "Delete a dataspace identity",
        "operationId": "delete_identity",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Identity deleted, idempotent"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/credentials": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "List a dataspace identity's wallet credentials",
        "description": "Pass-through over the cluster API seam after the platform-side org check. The listing is filtered client-side to usage Holder — status-list and issuance-tracking bookkeeping is excluded — and each state integer is mapped to its VcStatus name. The optional type query param is forwarded verbatim.",
        "operationId": "list_wallet_credentials",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by the credential type carried in the nested container.",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The identity's wallet credentials",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WalletCredentialView"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The cluster layer rejected the request"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "put": {
        "tags": [
          "EDC"
        ],
        "summary": "Update a wallet credential",
        "description": "Proxies the hub's VerifiableCredentialManifest verbatim over the cluster API seam after the platform-side org check; the manifest's id is the row key. Success is a 204 with no body; an absent id relays the hub's 404 as the house NotFound. Validation is transport-level only — a non-blank id.",
        "operationId": "update_wallet_credential",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WalletCredentialManifest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Wallet credential updated"
          },
          "400": {
            "description": "The credential id is blank, or the cluster layer rejected the request"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity or credential not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Add a wallet credential",
        "description": "Proxies the hub's VerifiableCredentialManifest verbatim over the cluster API seam after the platform-side org check. Success is a 204 with no body; a re-add relays the hub's 409 as the house Conflict. Validation is transport-level only — a non-blank id.",
        "operationId": "add_wallet_credential",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WalletCredentialManifest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Wallet credential added"
          },
          "400": {
            "description": "The credential id is blank, or the cluster layer rejected the request"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          },
          "409": {
            "description": "A credential with that id already exists"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/credentials/request": {
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Request credentials from an issuer for a dataspace identity",
        "description": "Mints the holderPid platform-side as a UUID v7 and proxies the request to the identity hub over the cluster API seam. The 201 view is synthesised from the sent values with status CREATED; the first status GET is authoritative.",
        "operationId": "create_credential_request",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCredentialRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Credential request created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialRequestView"
                }
              }
            }
          },
          "400": {
            "description": "Invalid issuerDid or credential descriptors"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          },
          "409": {
            "description": "The cluster layer refused the request"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/credentials/request/{holder_pid}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get the status of a credential request",
        "description": "Pass-through over the cluster API seam after the platform-side org check. The tracked view mirrors the identity hub's credential request verbatim; the first GET after a create is authoritative.",
        "operationId": "get_credential_request",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "holder_pid",
            "in": "path",
            "description": "Holder credential request PID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The tracked credential request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CredentialRequestView"
                }
              }
            }
          },
          "400": {
            "description": "The holder pid is not a UUID"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity or credential request not found"
          },
          "409": {
            "description": "The cluster layer refused the request"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/credentials/{credential_id}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "summary": "Get a wallet credential",
        "description": "Pass-through over the cluster API seam after the platform-side org check. The credential id passes through raw — the seam rejects metacharacters — and an unknown id relays the hub's 404 as the house NotFound.",
        "operationId": "get_wallet_credential",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "credential_id",
            "in": "path",
            "description": "Wallet credential ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The wallet credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WalletCredentialView"
                }
              }
            }
          },
          "400": {
            "description": "The cluster layer rejected the request"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity or credential not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "summary": "Delete a wallet credential",
        "description": "Proxies the hub's delete over the cluster API seam after the platform-side org check. The credential id passes through raw — the seam rejects metacharacters. Success is a 204 with no body; an absent id relays the hub's 404 as the house NotFound.",
        "operationId": "delete_wallet_credential",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "credential_id",
            "in": "path",
            "description": "Wallet credential ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Wallet credential deleted"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity or credential not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/data-service": {
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Attach a data service to a dataspace identity",
        "description": "Proxies to the cluster layer, which registers the endpoint on the holder's connector.",
        "operationId": "attach_data_service",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttachDataService"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The identity with its data services",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityView"
                }
              }
            }
          },
          "400": {
            "description": "The cluster layer rejected the service endpoint"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          },
          "409": {
            "description": "The cluster layer refused the attach"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/dataspace-profiles": {
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Pair a dataspace identity with dataspace profiles",
        "description": "Materialises each referenced platform dataspace profile into the connector's namespace (idempotent upsert) and sets the resulting refs as the holder's full desired pairing set. The onboarding operator resolves each profile and registers its DCP scope mapping and DID contexts on the identity hub.",
        "operationId": "attach_dataspace_profiles",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AttachDataspaceProfiles"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The identity with its dataspace-profile pairings",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentityView"
                }
              }
            }
          },
          "400": {
            "description": "The pairing set is empty or the cluster layer rejected it"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity or dataspace profile not found"
          },
          "409": {
            "description": "The cluster layer refused the attach"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identities/{identity_id}/presentations/query": {
      "post": {
        "tags": [
          "EDC"
        ],
        "summary": "Query presentation material for a dataspace identity",
        "description": "Pass-through over the cluster API seam after the platform-side org check. The body relays verbatim to the identity hub's presentations query — the hub governs the DCP semantics (D11). A fresh self-issued token is minted per query seam-side; statuses relay as-is. The response is the assembled presentation material as a bare array — each element a JWT string or a JSON object — with the DCP envelope dropped.",
        "operationId": "query_presentations",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "identity_id",
            "in": "path",
            "description": "Dataspace identity ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PresentationQueryMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The assembled presentation material",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/VerifiablePresentation"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The cluster layer rejected the request"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          },
          "404": {
            "description": "Identity not found"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/edc/identityhub/{name}/{version}/participants/{participant_id}/dids/{did}/endpoints": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Adds a service endpoint to a particular DID document.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "did",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "autoPublish",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The DID document was successfully updated."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The service endpoint could not be added because the DID does not exist."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The DID document could not be updated, because a service endpoint with the same ID already exists."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "identity:write"
            ]
          }
        ],
        "operationId": "addDidEndpoint",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IdentityhubService"
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "description": "Removes a service endpoint from a particular DID document.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "did",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "serviceId",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "autoPublish",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The DID document was successfully updated."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The DID document could not be updated, because a service endpoint with the same ID already exists."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The service endpoint could not be added because the DID does not exist."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "identity:write"
            ]
          }
        ],
        "operationId": "deleteDidEndpoint"
      },
      "patch": {
        "tags": [
          "EDC"
        ],
        "description": "Replaces a service endpoint of a particular DID document.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "did",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "autoPublish",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The DID document was successfully updated."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The DID document could not be updated, because a service endpoint with the given ID does not exist."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IdentityhubApiErrorDetail"
                  }
                }
              }
            },
            "description": "The service endpoint could not be replaced because the DID does not exist."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "identity:write"
            ]
          }
        ],
        "operationId": "replaceDidEndpoint",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IdentityhubService"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/attestations": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Creates an attestation definition in the runtime.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "The attestation definition was added successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The holder was not found."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't add the holder, because a object with the same ID already exists"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "createAttestation",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceAttestationDefinitionRequest"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/attestations/query": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Query attestation definitions",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceAttestationDefinition"
                  }
                }
              }
            },
            "description": "A list of attestation metadata."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:read"
            ]
          }
        ],
        "operationId": "queryAttestations",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceQuerySpec"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/attestations/{attestationDefinitionId}": {
      "delete": {
        "tags": [
          "EDC"
        ],
        "description": "Deletes an attestation definition.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "attestationDefinitionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The attestation was successfully deleted."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The attestation or the participant was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "deleteAttestation"
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentialdefinitions": {
      "put": {
        "tags": [
          "EDC"
        ],
        "description": "Updates credential definition.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The credential definition was updated successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't update the credential definition because it was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "updateCredentialDefinition",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceCredentialDefinitionDto"
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Adds a new credential definition.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "The credential definition was created successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't create the credential definition, because a object with the same ID already exists"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "createCredentialDefinition",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceCredentialDefinitionDto"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentialdefinitions/query": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Gets all credential definitions for a certain query.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceCredentialDefinition"
                  }
                }
              }
            },
            "description": "A list of credentials definitions."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:read"
            ]
          }
        ],
        "operationId": "queryCredentialDefinitions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceQuerySpec"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentialdefinitions/{credentialDefinitionId}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "description": "Gets a credential definition by its ID.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "credentialDefinitionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerserviceCredentialDefinition"
                }
              }
            },
            "description": "The credential definition was found."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The credential definition was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:read"
            ]
          }
        ],
        "operationId": "getCredentialDefinitionById"
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "description": "Deletes a credential definition by its ID.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "credentialDefinitionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerserviceCredentialDefinition"
                }
              }
            },
            "description": "The credential definition was deleted."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The credential definition was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "deleteCredentialDefinitionById"
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentials/offer": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Triggers a DCP CredentialOffer message being sent to the holder.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The CredentialOfferMessage was sent to the holder successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed. For example when the holder DID is not resolvable, or the credential type, format, etc. is not known/invalid."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The participant context (=issuer) is not permitted to interact with the specified holder."
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "credential:write"
            ]
          }
        ],
        "operationId": "sendCredentialOffer",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceCredentialOfferDto"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentials/query": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Query credentials, possibly across multiple participants.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceVerifiableCredentialResourceDto"
                  }
                }
              }
            },
            "description": "A list of verifiable credential metadata. Note that these are not actual VerifiableCredentials."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "credential:read"
            ]
          }
        ],
        "operationId": "queryCredentials",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceQuerySpec"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentials/{credentialId}/revoke": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Revokes a credential with the given ID for the given participant. Revoked credentials will be added to the Revocation List",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "credentialId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The credential was revoked successfully. Check the Revocation List credential to confirm."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The credential or the participant was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "credential:write"
            ]
          }
        ],
        "operationId": "revokeCredential"
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/credentials/{credentialId}/status": {
      "get": {
        "tags": [
          "EDC"
        ],
        "description": "Checks the revocation status of a credential with the given ID for the given participant.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "credentialId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The credential status."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The credential or the participant was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "credential:read"
            ]
          }
        ],
        "operationId": "checkCredentialStatus"
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/dids/{did}/contexts": {
      "put": {
        "tags": [
          "EDC"
        ],
        "description": "Directly mapped to PUT /v5beta/participants/{participantContextId}/dids/{did}/contexts of the issuerservice EDC component. Requires the issuer:write scope.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "did",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response"
          },
          "401": {
            "description": "Platform-side house error before any relay traffic"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          }
        },
        "security": [
          {
            "bearer": [
              "issuer:write"
            ]
          }
        ],
        "operationId": "putContexts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceDidContextsRequest"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/holders": {
      "put": {
        "tags": [
          "EDC"
        ],
        "description": "Updates holder data.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The holder was updated successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't update the holder because it was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "holder:write"
            ]
          }
        ],
        "operationId": "updateHolder",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceHolderDto"
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Adds a new holder.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "The holder was added successfully."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't add the holder, because a object with the same ID already exists"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "holder:write"
            ]
          }
        ],
        "operationId": "addHolder",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceHolderDto"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/holders/query": {
      "post": {
        "tags": [
          "EDC"
        ],
        "description": "Gets all holders for a certain query.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceHolder"
                  }
                }
              }
            },
            "description": "A list of holders metadata."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The holder was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "holder:read"
            ]
          }
        ],
        "operationId": "queryHolders",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IssuerserviceQuerySpec"
              }
            }
          }
        }
      }
    },
    "/v1/organisations/{organisation_id}/edc/issuerservice/{name}/{version}/participants/{participant_id}/holders/{holderId}": {
      "get": {
        "tags": [
          "EDC"
        ],
        "description": "Gets metadata for a certain holder.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "holderId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssuerserviceHolder"
                }
              }
            },
            "description": "A list of verifiable credential metadata. Note that these are not actual VerifiableCredentials."
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Request body was malformed, or the request could not be processed"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The holder was not found."
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "holder:read"
            ]
          }
        ],
        "operationId": "getHolderById"
      },
      "delete": {
        "tags": [
          "EDC"
        ],
        "description": "Delete a holder.",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "holderId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The holder was deleted successfully."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "The request could not be completed, because either the authentication was missing or was not valid."
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IssuerserviceApiErrorDetail"
                  }
                }
              }
            },
            "description": "Can't add the holder, because a object with the same ID already exists"
          },
          "403": {
            "description": "Platform-side house error before any relay traffic"
          },
          "404": {
            "description": "Platform-side house error before any relay traffic"
          },
          "default": {
            "description": "Relayed from the EDC component"
          }
        },
        "security": [
          {
            "bearer": [
              "holder:write"
            ]
          }
        ],
        "operationId": "deleteHolder"
      }
    },
    "/v1/organisations/{organisation_id}/members": {
      "get": {
        "tags": [
          "Organisations"
        ],
        "summary": "List organisation members",
        "operationId": "list_members",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The organisation's members",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrganisationMember"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not a member of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      },
      "post": {
        "tags": [
          "Organisations"
        ],
        "summary": "Invite a member by email",
        "operationId": "invite_member",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrganisationMemberInvitation"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Member invited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganisationMember"
                }
              }
            }
          },
          "400": {
            "description": "Invalid email"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          },
          "409": {
            "description": "User is already a member"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v1/organisations/{organisation_id}/members/{user_id}": {
      "delete": {
        "tags": [
          "Organisations"
        ],
        "summary": "Remove a member",
        "operationId": "remove_member",
        "parameters": [
          {
            "name": "organisation_id",
            "in": "path",
            "description": "Organisation ID",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "Keycloak user ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Member removed, idempotent"
          },
          "401": {
            "description": "Missing or malformed bearer token"
          },
          "403": {
            "description": "Not an owner of the organisation"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ActivityLogEvent": {
        "type": "object",
        "required": [
          "id",
          "organisationId",
          "timestamp",
          "actorType",
          "actorId",
          "action",
          "resourceType",
          "outcome"
        ],
        "properties": {
          "action": {
            "type": "string"
          },
          "actorId": {
            "type": "string"
          },
          "actorType": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "metadata": {},
          "organisationId": {
            "type": "string",
            "format": "uuid"
          },
          "outcome": {
            "type": "string"
          },
          "resourceId": {
            "type": [
              "string",
              "null"
            ]
          },
          "resourceType": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "ApiKey": {
        "type": "object",
        "required": [
          "id",
          "name",
          "scopes",
          "keyPrefix",
          "enabled",
          "createdAt"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "enabled": {
            "type": "boolean"
          },
          "expiresAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "keyPrefix": {
            "type": "string"
          },
          "lastExchangedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "rotatedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ApiKeyCreated": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ApiKey"
          },
          {
            "type": "object",
            "required": [
              "secret"
            ],
            "properties": {
              "secret": {
                "type": "string"
              }
            }
          }
        ]
      },
      "AttachDataService": {
        "type": "object",
        "required": [
          "serviceEndpoint"
        ],
        "properties": {
          "serviceEndpoint": {
            "type": "string"
          }
        }
      },
      "AttachDataspaceProfiles": {
        "type": "object",
        "required": [
          "dataspaceProfileIds"
        ],
        "properties": {
          "dataspaceProfileIds": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            }
          }
        }
      },
      "AttestationDefinitionView": {
        "type": "object",
        "required": [
          "id",
          "attestationType"
        ],
        "properties": {
          "attestationType": {
            "type": "string"
          },
          "configuration": {},
          "createdAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "id": {
            "type": "string"
          },
          "lastModifiedAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "participantContextId": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "AuthoritySummary": {
        "type": "object",
        "required": [
          "name",
          "ready"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "ready": {
            "type": "boolean"
          }
        }
      },
      "ClusterCredentialMapping": {
        "type": "object",
        "required": [
          "input",
          "output"
        ],
        "properties": {
          "input": {
            "type": "string"
          },
          "output": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          }
        }
      },
      "ClusterProfileRef": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "namespace": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "ClusterServiceEndpoint": {
        "type": "object",
        "required": [
          "id",
          "type",
          "serviceEndpoint"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "serviceEndpoint": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "ConnectorSummary": {
        "type": "object",
        "required": [
          "name",
          "ready"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "ready": {
            "type": "boolean"
          }
        }
      },
      "CreateApiKeyRequest": {
        "type": "object",
        "required": [
          "name",
          "scopes"
        ],
        "properties": {
          "expiresInDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "name": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "CreateCredentialDefinition": {
        "type": "object",
        "required": [
          "credentialType",
          "format",
          "jsonSchema",
          "attestations"
        ],
        "properties": {
          "attestations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "jsonSchema": {
            "type": "string"
          },
          "jsonSchemaUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "mappings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClusterCredentialMapping"
            }
          },
          "validity": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          }
        }
      },
      "CreateCredentialDescriptor": {
        "type": "object",
        "required": [
          "id",
          "format"
        ],
        "properties": {
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "CreateCredentialRequest": {
        "type": "object",
        "required": [
          "issuerDid",
          "credentials"
        ],
        "properties": {
          "credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreateCredentialDescriptor"
            }
          },
          "issuerDid": {
            "type": "string"
          }
        }
      },
      "CreateHolder": {
        "type": "object",
        "required": [
          "did"
        ],
        "properties": {
          "did": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "properties": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            }
          }
        }
      },
      "CreateIdentity": {
        "type": "object",
        "required": [
          "displayName"
        ],
        "properties": {
          "connector": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "displayName": {
            "type": "string"
          }
        }
      },
      "CreateIssuer": {
        "type": "object",
        "required": [
          "displayName"
        ],
        "properties": {
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "didContextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Extra JSON-LD `@context` URLs to manage on the issuer's DID document\n(e.g. the CX-0049 context set). The cluster seam stamps them onto the\n`IssuingAuthority` spec and the onboarding operator converges them onto\nthe issuer's DID document. Absent means nothing to manage."
          },
          "displayName": {
            "type": "string"
          }
        }
      },
      "CredentialDefinitionView": {
        "type": "object",
        "required": [
          "id",
          "credentialType",
          "format",
          "attestations",
          "mappings"
        ],
        "properties": {
          "additionalContext": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "attestations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "createdAt": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "jsonSchema": {
            "type": [
              "string",
              "null"
            ]
          },
          "jsonSchemaUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "mappings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClusterCredentialMapping"
            }
          },
          "participantContextId": {
            "type": [
              "string",
              "null"
            ]
          },
          "rules": {
            "type": [
              "array",
              "null"
            ],
            "items": {}
          },
          "validity": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          }
        }
      },
      "CredentialFormat": {
        "type": "string",
        "enum": [
          "VC1_0_LD",
          "VC1_0_JWT",
          "VC2_0_JOSE",
          "VC2_0_SD_JWT",
          "VC2_0_COSE"
        ]
      },
      "CredentialRequestView": {
        "type": "object",
        "required": [
          "holderPid",
          "issuerDid",
          "status",
          "typesAndFormats"
        ],
        "properties": {
          "holderPid": {
            "type": "string"
          },
          "issuerDid": {
            "type": "string"
          },
          "issuerPid": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "typesAndFormats": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RequestedCredentialView"
            }
          }
        }
      },
      "CredentialStatusDto": {
        "type": "object",
        "required": [
          "credentialId",
          "status"
        ],
        "properties": {
          "credentialId": {
            "type": "string"
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          }
        }
      },
      "CredentialView": {
        "type": "object",
        "properties": {
          "format": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CredentialFormat"
              }
            ]
          },
          "holderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "issuerId": {
            "type": [
              "string",
              "null"
            ]
          },
          "participantContextId": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "timestamp": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "type": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Dataspace": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "displayName",
          "visibility",
          "ownerOrganisationId",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "displayName": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "ownerOrganisationId": {
            "type": "string",
            "format": "uuid"
          },
          "slug": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "visibility": {
            "type": "string"
          }
        }
      },
      "DataspaceDiscoveryEntry": {
        "type": "object",
        "required": [
          "id",
          "dataspaceSlug",
          "dataspaceDisplayName",
          "organisationId",
          "organisationDisplayName",
          "versionSlug",
          "versionStage",
          "versionPreview",
          "versionLts",
          "profileSlug",
          "dspVersionDisplay",
          "authProtocol"
        ],
        "properties": {
          "authProtocol": {
            "type": "string"
          },
          "dataspaceDisplayName": {
            "type": "string"
          },
          "dataspaceSlug": {
            "type": "string"
          },
          "dspVersionDisplay": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "organisationDisplayName": {
            "type": "string"
          },
          "organisationId": {
            "type": "string",
            "format": "uuid"
          },
          "profileSlug": {
            "type": "string"
          },
          "versionLts": {
            "type": "boolean"
          },
          "versionPreview": {
            "type": "boolean"
          },
          "versionSlug": {
            "type": "string"
          },
          "versionStage": {
            "type": "string"
          }
        }
      },
      "DataspaceProfile": {
        "type": "object",
        "required": [
          "id",
          "dataspaceVersionId",
          "slug",
          "dspVersion",
          "dspVersionDisplay",
          "authProtocol",
          "document",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "authProtocol": {
            "type": "string"
          },
          "authVersion": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "dataspaceVersionId": {
            "type": "string",
            "format": "uuid"
          },
          "document": {
            "$ref": "#/components/schemas/ProfileDocument"
          },
          "dspVersion": {
            "type": "string"
          },
          "dspVersionDisplay": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "slug": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "DataspaceRegistration": {
        "type": "object",
        "required": [
          "slug",
          "displayName"
        ],
        "properties": {
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "displayName": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "DataspaceVersion": {
        "type": "object",
        "required": [
          "id",
          "dataspaceId",
          "slug",
          "stage",
          "preview",
          "lts",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "dataspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "lts": {
            "type": "boolean"
          },
          "preview": {
            "type": "boolean"
          },
          "slug": {
            "type": "string"
          },
          "stage": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "DataspaceVersionLtsUpdate": {
        "type": "object",
        "required": [
          "enabled"
        ],
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        }
      },
      "DataspaceVersionRegistration": {
        "type": "object",
        "required": [
          "slug"
        ],
        "properties": {
          "lts": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "DataspaceVisibilityUpdate": {
        "type": "object",
        "required": [
          "visibility"
        ],
        "properties": {
          "visibility": {
            "type": "string"
          }
        }
      },
      "ExchangeRequest": {
        "type": "object",
        "required": [
          "grant_type",
          "subject_token",
          "subject_token_type"
        ],
        "properties": {
          "grant_type": {
            "type": "string"
          },
          "subject_token": {
            "type": "string"
          },
          "subject_token_type": {
            "type": "string"
          }
        }
      },
      "ExchangeResponse": {
        "type": "object",
        "required": [
          "access_token",
          "token_type",
          "expires_in",
          "issued_token_type"
        ],
        "properties": {
          "access_token": {
            "type": "string"
          },
          "expires_in": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "issued_token_type": {
            "type": "string"
          },
          "token_type": {
            "type": "string"
          }
        }
      },
      "Holder": {
        "type": "object",
        "properties": {
          "anonymous": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "did": {
            "type": [
              "string",
              "null"
            ]
          },
          "holderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "holderName": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": [
              "string",
              "null"
            ]
          },
          "lastModifiedAt": {
            "type": "integer",
            "format": "int64"
          },
          "participantContextId": {
            "type": [
              "string",
              "null"
            ]
          },
          "properties": {
            "type": "object",
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            }
          }
        }
      },
      "IdentityView": {
        "type": "object",
        "required": [
          "id",
          "did",
          "connector",
          "active",
          "ready",
          "serviceEndpoints",
          "dataspaceProfiles"
        ],
        "properties": {
          "active": {
            "type": "boolean"
          },
          "connector": {
            "type": "string"
          },
          "dataspaceProfiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PairedDataspaceProfile"
            }
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "did": {
            "type": "string"
          },
          "displayName": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "ready": {
            "type": "boolean"
          },
          "serviceEndpoints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClusterServiceEndpoint"
            }
          }
        }
      },
      "IssuerView": {
        "type": "object",
        "required": [
          "id",
          "org",
          "did",
          "authority",
          "active",
          "ready",
          "serviceEndpoints",
          "participantContextId"
        ],
        "properties": {
          "active": {
            "type": "boolean"
          },
          "authority": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "did": {
            "type": "string"
          },
          "didContextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "displayName": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "org": {
            "type": "string"
          },
          "participantContextId": {
            "type": "string"
          },
          "ready": {
            "type": "boolean"
          },
          "serviceEndpoints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClusterServiceEndpoint"
            }
          }
        }
      },
      "OfferCredentials": {
        "type": "object",
        "required": [
          "credentials"
        ],
        "properties": {
          "credentials": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "offerReason": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "Organisation": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "displayName",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "displayName": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "slug": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "OrganisationMember": {
        "type": "object",
        "required": [
          "userId",
          "email",
          "username",
          "role"
        ],
        "properties": {
          "email": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          },
          "username": {
            "type": "string"
          }
        }
      },
      "OrganisationMemberInvitation": {
        "type": "object",
        "required": [
          "email"
        ],
        "properties": {
          "email": {
            "type": "string"
          }
        }
      },
      "OrganisationRegistration": {
        "type": "object",
        "required": [
          "slug",
          "displayName"
        ],
        "properties": {
          "displayName": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "OrganisationSummary": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "displayName"
        ],
        "properties": {
          "displayName": {
            "type": "string"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "Page_ActivityLogEvent": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "organisationId",
                "timestamp",
                "actorType",
                "actorId",
                "action",
                "resourceType",
                "outcome"
              ],
              "properties": {
                "action": {
                  "type": "string"
                },
                "actorId": {
                  "type": "string"
                },
                "actorType": {
                  "type": "string"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "metadata": {},
                "organisationId": {
                  "type": "string",
                  "format": "uuid"
                },
                "outcome": {
                  "type": "string"
                },
                "resourceId": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "resourceType": {
                  "type": "string"
                },
                "timestamp": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "Page_ApiKey": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "scopes",
                "keyPrefix",
                "enabled",
                "createdAt"
              ],
              "properties": {
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "enabled": {
                  "type": "boolean"
                },
                "expiresAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "keyPrefix": {
                  "type": "string"
                },
                "lastExchangedAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "name": {
                  "type": "string"
                },
                "rotatedAt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "scopes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "Page_Dataspace": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "slug",
                "displayName",
                "visibility",
                "ownerOrganisationId",
                "createdAt",
                "updatedAt"
              ],
              "properties": {
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "displayName": {
                  "type": "string"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "ownerOrganisationId": {
                  "type": "string",
                  "format": "uuid"
                },
                "slug": {
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "visibility": {
                  "type": "string"
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "Page_DataspaceDiscoveryEntry": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "dataspaceSlug",
                "dataspaceDisplayName",
                "organisationId",
                "organisationDisplayName",
                "versionSlug",
                "versionStage",
                "versionPreview",
                "versionLts",
                "profileSlug",
                "dspVersionDisplay",
                "authProtocol"
              ],
              "properties": {
                "authProtocol": {
                  "type": "string"
                },
                "dataspaceDisplayName": {
                  "type": "string"
                },
                "dataspaceSlug": {
                  "type": "string"
                },
                "dspVersionDisplay": {
                  "type": "string"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "organisationDisplayName": {
                  "type": "string"
                },
                "organisationId": {
                  "type": "string",
                  "format": "uuid"
                },
                "profileSlug": {
                  "type": "string"
                },
                "versionLts": {
                  "type": "boolean"
                },
                "versionPreview": {
                  "type": "boolean"
                },
                "versionSlug": {
                  "type": "string"
                },
                "versionStage": {
                  "type": "string"
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "Page_DataspaceProfile": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "dataspaceVersionId",
                "slug",
                "dspVersion",
                "dspVersionDisplay",
                "authProtocol",
                "document",
                "createdAt",
                "updatedAt"
              ],
              "properties": {
                "authProtocol": {
                  "type": "string"
                },
                "authVersion": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "dataspaceVersionId": {
                  "type": "string",
                  "format": "uuid"
                },
                "document": {
                  "$ref": "#/components/schemas/ProfileDocument"
                },
                "dspVersion": {
                  "type": "string"
                },
                "dspVersionDisplay": {
                  "type": "string"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "slug": {
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "Page_DataspaceVersion": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "dataspaceId",
                "slug",
                "stage",
                "preview",
                "lts",
                "createdAt",
                "updatedAt"
              ],
              "properties": {
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "dataspaceId": {
                  "type": "string",
                  "format": "uuid"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "lts": {
                  "type": "boolean"
                },
                "preview": {
                  "type": "boolean"
                },
                "slug": {
                  "type": "string"
                },
                "stage": {
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            },
            "description": "The items on this page."
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Opaque cursor to pass as `?cursor=` on the next request."
          }
        }
      },
      "PairedDataspaceProfile": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "dataspaceDisplayName": {
            "type": [
              "string",
              "null"
            ]
          },
          "dspVersionDisplay": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "namespace": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "PresentationQueryMessage": {
        "type": "object",
        "properties": {
          "presentationDefinition": {},
          "scope": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ProfileAdditionalIdentifier": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string"
          }
        }
      },
      "ProfileAuth": {
        "type": "object",
        "required": [
          "protocol"
        ],
        "properties": {
          "credentialFormats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "protocol": {
            "type": "string"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "version": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "ProfileCredentialSpec": {
        "type": "object",
        "required": [
          "type",
          "format"
        ],
        "properties": {
          "format": {
            "type": "string"
          },
          "properties": {},
          "requiredForRoles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "trustedIssuers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "type": {
            "type": "string"
          }
        }
      },
      "ProfileDocument": {
        "type": "object",
        "required": [
          "protocol",
          "auth",
          "participantIdentifier",
          "transferTypes",
          "policy"
        ],
        "properties": {
          "auth": {
            "$ref": "#/components/schemas/ProfileAuth"
          },
          "credentialContextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "credentialSpecs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfileCredentialSpec"
            }
          },
          "dcpScopeAlias": {
            "type": [
              "string",
              "null"
            ]
          },
          "didContextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "jsonLdContexts": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "participantIdentifier": {
            "$ref": "#/components/schemas/ProfileParticipantIdentifier"
          },
          "policy": {
            "$ref": "#/components/schemas/ProfilePolicy"
          },
          "protocol": {
            "$ref": "#/components/schemas/ProfileProtocol"
          },
          "transferTypes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfileTransferType"
            }
          }
        }
      },
      "ProfileParticipantIdentifier": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "additionalIdentifiers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfileAdditionalIdentifier"
            }
          },
          "type": {
            "type": "string"
          }
        }
      },
      "ProfilePolicy": {
        "type": "object",
        "required": [
          "profile"
        ],
        "properties": {
          "contexts": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "profile": {
            "type": "string"
          }
        }
      },
      "ProfileProtocol": {
        "type": "object",
        "required": [
          "dspVersion",
          "binding"
        ],
        "properties": {
          "binding": {
            "type": "string"
          },
          "dspVersion": {
            "type": "string"
          }
        }
      },
      "ProfileTransferType": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string"
          }
        }
      },
      "RequestedCredentialView": {
        "type": "object",
        "required": [
          "credentialType",
          "format",
          "id"
        ],
        "properties": {
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        }
      },
      "SetIssuerDidContexts": {
        "type": "object",
        "required": [
          "didContextUrls"
        ],
        "properties": {
          "didContextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The exact desired extra `@context` set. Must not be empty: clearing is\nnot supported — the onboarding operator treats an empty set as nothing\nto manage."
          }
        }
      },
      "UpdateCredentialDefinition": {
        "type": "object",
        "properties": {
          "additionalContext": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "attestations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "credentialType": {
            "type": [
              "string",
              "null"
            ]
          },
          "format": {
            "type": [
              "string",
              "null"
            ]
          },
          "jsonSchema": {
            "type": [
              "string",
              "null"
            ]
          },
          "jsonSchemaUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "mappings": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ClusterCredentialMapping"
            }
          },
          "rules": {
            "type": [
              "array",
              "null"
            ],
            "items": {}
          },
          "validity": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          }
        }
      },
      "UpdateHolder": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "properties": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            }
          }
        }
      },
      "VerifiablePresentation": {
        "oneOf": [
          {
            "type": "string"
          },
          {}
        ]
      },
      "WalletCredentialContainer": {
        "type": "object",
        "required": [
          "rawVc",
          "format",
          "credential"
        ],
        "properties": {
          "credential": {},
          "format": {
            "$ref": "#/components/schemas/CredentialFormat"
          },
          "rawVc": {
            "type": "string"
          }
        }
      },
      "WalletCredentialManifest": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "issuancePolicy": {},
          "participantContextId": {
            "type": [
              "string",
              "null"
            ]
          },
          "reissuancePolicy": {},
          "verifiableCredentialContainer": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WalletCredentialContainer"
              }
            ]
          }
        }
      },
      "WalletCredentialView": {
        "type": "object",
        "required": [
          "id",
          "state",
          "participantContextId"
        ],
        "properties": {
          "format": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/CredentialFormat"
              }
            ]
          },
          "holderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "issuerId": {
            "type": [
              "string",
              "null"
            ]
          },
          "participantContextId": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "timeOfLastStatusUpdate": {
            "type": [
              "string",
              "null"
            ]
          },
          "timestamp": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "type": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "usage": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "ControlplaneApiErrorDetail": {
        "type": "object",
        "example": {
          "message": "error message",
          "type": "ErrorType",
          "path": "object.error.path",
          "invalidValue": "this value is not valid"
        },
        "properties": {
          "invalidValue": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "ControlplaneDataFlowStatusMessage": {
        "type": "object",
        "properties": {
          "dataAddress": {
            "$ref": "#/components/schemas/ControlplaneDspDataAddress"
          },
          "error": {
            "type": "string"
          },
          "state": {
            "type": "string"
          }
        }
      },
      "ControlplaneDataPlaneRegistrationMessage": {
        "type": "object",
        "properties": {
          "authorization": {
            "type": "object",
            "additionalProperties": true
          },
          "dataplaneId": {
            "type": "string"
          },
          "endpoint": {
            "type": "string"
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          },
          "transferTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          }
        }
      },
      "ControlplaneDspDataAddress": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string"
          },
          "endpoint": {
            "type": "string"
          },
          "endpointProperties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneEndpointProperty"
            }
          },
          "endpointType": {
            "type": "string"
          }
        }
      },
      "ControlplaneEndpointProperty": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "ControlplaneFailure": {
        "type": "object",
        "properties": {
          "failureDetail": {
            "type": "string"
          },
          "messages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ControlplaneHealthCheckResult": {
        "type": "object",
        "properties": {
          "component": {
            "type": "string"
          },
          "failure": {
            "$ref": "#/components/schemas/ControlplaneFailure"
          },
          "isHealthy": {
            "type": "boolean"
          }
        }
      },
      "ControlplaneHealthStatus": {
        "type": "object",
        "properties": {
          "componentResults": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneHealthCheckResult"
            }
          },
          "isSystemHealthy": {
            "type": "boolean"
          }
        }
      },
      "ControlplaneJsonArray": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ControlplaneJsonValue"
        },
        "properties": {
          "empty": {
            "type": "boolean"
          },
          "first": {
            "$ref": "#/components/schemas/ControlplaneJsonValue"
          },
          "last": {
            "$ref": "#/components/schemas/ControlplaneJsonValue"
          },
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "ControlplaneJsonObject": {
        "type": "object",
        "additionalProperties": {
          "$ref": "#/components/schemas/ControlplaneJsonValue"
        },
        "properties": {
          "empty": {
            "type": "boolean"
          },
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "ControlplaneJsonValue": {
        "type": "object",
        "properties": {
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "ControlplaneVersionRecord": {
        "type": "object",
        "properties": {
          "lastUpdated": {
            "type": "string",
            "format": "date-time"
          },
          "maturity": {
            "type": "string"
          },
          "urlPath": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        }
      },
      "ControlplaneCachedDocument": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "CachedDocument"
          },
          "@id": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "documentType": {
            "type": "string",
            "enum": [
              "JSON_LD",
              "JSON_SCHEMA"
            ]
          },
          "pullStrategy": {
            "type": "string",
            "enum": [
              "NEVER",
              "IF_NOT_PRESENT",
              "ALWAYS"
            ]
          },
          "content": {
            "type": "object"
          }
        },
        "required": [
          "@context",
          "@type",
          "url"
        ]
      },
      "ControlplaneApiError": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "invalidValue": {
            "type": "string"
          }
        },
        "required": [
          "message",
          "type"
        ]
      },
      "ControlplaneIdResponse": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "IdResponse"
          },
          "@id": {
            "type": "string"
          },
          "createdAt": {
            "type": "number"
          }
        },
        "required": [
          "@context",
          "@type",
          "@id",
          "createdAt"
        ]
      },
      "ControlplaneCelExpression": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "CelExpression"
          },
          "@id": {
            "type": "string"
          },
          "leftOperand": {
            "type": "string"
          },
          "expression": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          },
          "supportedOperators": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "EQ",
                "NEQ",
                "GT",
                "GEQ",
                "LT",
                "LEQ",
                "IS_PART_OF",
                "IN",
                "HAS_PART",
                "IS_A",
                "IS_ALL_OF",
                "IS_ANY_OF",
                "IS_NONE_OF"
              ]
            },
            "uniqueItems": true
          }
        },
        "required": [
          "@context",
          "@type",
          "leftOperand",
          "expression",
          "description"
        ]
      },
      "ControlplaneQuerySpec": {
        "type": "object",
        "allOf": [
          {
            "properties": {
              "@context": {
                "$ref": "#/components/schemas/ControlplaneContext"
              }
            }
          },
          {
            "$ref": "#/components/schemas/ControlplaneQuerySpec"
          }
        ],
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneQuerySpecRoot": {
        "type": "object",
        "allOf": [
          {
            "properties": {
              "@context": {
                "$ref": "#/components/schemas/ControlplaneContext"
              }
            }
          },
          {
            "$ref": "#/components/schemas/ControlplaneQuerySpec"
          }
        ],
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneCriterion": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "const": "Criterion"
          },
          "operandLeft": {
            "type": "string"
          },
          "operandRight": {},
          "operator": {
            "type": "string"
          }
        },
        "required": [
          "@type",
          "operandLeft",
          "operandRight",
          "operator"
        ]
      },
      "ControlplaneCelExpressionTestRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "CelExpressionTestRequest"
          },
          "expression": {
            "type": "string"
          },
          "leftOperand": {
            "type": "string"
          },
          "operator": {
            "type": "string"
          },
          "rightOperand": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "object"
              }
            ]
          },
          "params": {
            "type": "object"
          }
        },
        "required": [
          "@context",
          "@type",
          "leftOperand",
          "expression",
          "rightOperand",
          "operator"
        ]
      },
      "ControlplaneCelExpressionTestResponse": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "CelExpressionTestResponse"
          },
          "evaluationResult": {
            "type": "boolean"
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneDataspaceProfile": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "DataspaceProfile"
          },
          "name": {
            "type": "string"
          },
          "protocol": {
            "type": "object",
            "properties": {
              "version": {
                "type": "string"
              },
              "path": {
                "type": "string"
              },
              "binding": {
                "type": "string"
              },
              "namespace": {
                "type": "string"
              }
            },
            "required": [
              "version",
              "binding",
              "namespace"
            ]
          },
          "jsonLdContextsUrl": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "trustedIssuers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "@id": {
                  "type": "string"
                },
                "supportedTypes": {
                  "type": "array",
                  "minItems": 1,
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "@id",
                "supportedTypes"
              ]
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "name",
          "protocol"
        ]
      },
      "ControlplaneDcpScope": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "DcpScope"
          },
          "@id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "DEFAULT",
              "POLICY"
            ]
          },
          "value": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "prefixMapping": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "value"
        ]
      },
      "ControlplaneParticipantContext": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ParticipantContext"
          },
          "@id": {
            "type": "string"
          },
          "identity": {
            "type": "string"
          },
          "properties": {
            "type": "object"
          },
          "state": {
            "type": "string",
            "enum": [
              "CREATED",
              "ACTIVATED",
              "DEACTIVATED"
            ]
          }
        },
        "required": [
          "@context",
          "@type",
          "identity"
        ]
      },
      "ControlplaneAsset": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "Asset"
          },
          "@id": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "example": {
              "key": "value"
            },
            "properties": {
              "conformsTo": {
                "type": "string"
              }
            }
          },
          "privateProperties": {
            "type": "object",
            "example": {
              "privateKey": "privateValue"
            }
          },
          "dataplaneMetadata": {
            "$ref": "#/components/schemas/ControlplaneDataplaneMetadata"
          }
        },
        "required": [
          "@context",
          "@type",
          "properties"
        ]
      },
      "ControlplaneCatalogRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "CatalogRequest"
          },
          "@id": {
            "type": "string"
          },
          "protocol": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "counterPartyAddress": {
            "type": "string"
          },
          "counterPartyId": {
            "type": "string"
          },
          "additionalScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "querySpec": {
            "$ref": "#/components/schemas/ControlplaneQuerySpec"
          }
        },
        "oneOf": [
          {
            "required": [
              "protocol"
            ],
            "not": {
              "required": [
                "profile"
              ]
            }
          },
          {
            "required": [
              "profile"
            ],
            "not": {
              "required": [
                "protocol"
              ]
            }
          }
        ],
        "required": [
          "@context",
          "@type",
          "counterPartyAddress",
          "counterPartyId"
        ]
      },
      "ControlplaneAbstractDataset": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneResource"
          },
          {
            "properties": {
              "distribution": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ControlplaneDistribution"
                },
                "minItems": 1
              }
            }
          }
        ]
      },
      "ControlplaneDataset": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneDataset"
          }
        ],
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          }
        },
        "required": [
          "@context"
        ]
      },
      "ControlplaneRootDataset": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneDataset"
          }
        ],
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          }
        },
        "required": [
          "@context"
        ]
      },
      "ControlplaneResource": {
        "type": "object",
        "properties": {
          "@id": {
            "type": "string"
          }
        },
        "required": [
          "@id"
        ]
      },
      "ControlplaneDistribution": {
        "type": "object",
        "properties": {
          "hasPolicy": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneOffer"
            },
            "minItems": 1
          },
          "accessService": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "$ref": "#/components/schemas/ControlplaneDataService"
              }
            ]
          },
          "format": {
            "type": "string"
          }
        },
        "required": [
          "accessService",
          "format"
        ]
      },
      "ControlplaneDataService": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneResource"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "DataService"
              },
              "endpointURL": {
                "type": "string"
              },
              "servesDataset": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ControlplaneDataset"
                },
                "minItems": 1
              }
            },
            "required": [
              "@type",
              "endpointURL"
            ]
          }
        ]
      },
      "ControlplaneReference": {
        "type": "object",
        "properties": {
          "@id": {
            "type": "string"
          }
        },
        "required": [
          "@id"
        ]
      },
      "ControlplaneRootCatalog": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneCatalog"
          }
        ],
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "participantId": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "participantId"
        ]
      },
      "ControlplaneCatalog": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneCatalog"
          }
        ],
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "participantId": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "participantId"
        ]
      },
      "ControlplaneParticipantContextConfig": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ParticipantContextConfig"
          },
          "entries": {
            "type": "object"
          },
          "privateEntries": {
            "type": "object"
          }
        },
        "required": [
          "@context",
          "@type",
          "entries"
        ]
      },
      "ControlplaneContractAgreement": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ContractAgreement"
          },
          "@id": {
            "type": "string"
          },
          "assetId": {
            "type": "string"
          },
          "providerId": {
            "type": "string"
          },
          "consumerId": {
            "type": "string"
          },
          "contractSigningDate": {
            "type": "integer"
          },
          "policy": {
            "$ref": "#/components/schemas/ControlplaneAgreement"
          }
        },
        "required": [
          "@context",
          "@type",
          "@id",
          "assetId",
          "providerId",
          "consumerId",
          "contractSigningDate",
          "policy"
        ]
      },
      "ControlplaneContractDefinition": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ContractDefinition"
          },
          "@id": {
            "type": "string"
          },
          "accessPolicyId": {
            "type": "string"
          },
          "contractPolicyId": {
            "type": "string"
          },
          "privateProperties": {
            "type": "object"
          },
          "assetsSelector": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneCriterion"
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "accessPolicyId",
          "contractPolicyId"
        ]
      },
      "ControlplaneContractRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ContractRequest"
          },
          "@id": {
            "type": "string"
          },
          "counterPartyAddress": {
            "type": "string"
          },
          "protocol": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "policy": {
            "$ref": "#/components/schemas/ControlplaneContractOffer"
          },
          "callbackAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneCallbackAddress"
            }
          }
        },
        "oneOf": [
          {
            "required": [
              "protocol"
            ],
            "not": {
              "required": [
                "profile"
              ]
            }
          },
          {
            "required": [
              "profile"
            ],
            "not": {
              "required": [
                "protocol"
              ]
            }
          }
        ],
        "required": [
          "@context",
          "@type",
          "counterPartyAddress",
          "policy"
        ]
      },
      "ControlplaneContractNegotiation": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "ContractNegotiation"
          },
          "@id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "CONSUMER",
              "PROVIDER"
            ]
          },
          "state": {
            "type": "string"
          },
          "pending": {
            "type": "boolean"
          },
          "stateTimestamp": {
            "type": "integer"
          },
          "protocol": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer"
          },
          "callbackAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneCallbackAddress"
            }
          },
          "counterPartyAddress": {
            "type": "string"
          },
          "counterPartyId": {
            "type": "string"
          },
          "errorDetail": {
            "type": "string"
          },
          "correlationId": {
            "type": "string"
          },
          "assetId": {
            "type": "string"
          },
          "policy": {
            "$ref": "#/components/schemas/ControlplanePolicyClass"
          },
          "contractAgreementId": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "@id",
          "type",
          "state",
          "profile",
          "protocol",
          "counterPartyAddress",
          "counterPartyId",
          "createdAt"
        ]
      },
      "ControlplaneNegotiationState": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "state"
        ]
      },
      "ControlplaneTerminateNegotiation": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TerminateNegotiation"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneContractTerminate": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TerminateNegotiation"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneDiscoveryRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "DiscoveryRequest"
          },
          "counterPartyId": {
            "type": "string",
            "description": "The counter party's DID. The DID is resolved and the 'DataService' entry of the DID document provides the base URL of the well-known endpoint."
          },
          "counterPartyAddress": {
            "type": "string",
            "format": "uri",
            "description": "The counter party's discovery URL pointing directly at the '/.well-known/dspace-version' endpoint, or the host that serves it. Takes precedence over counterPartyId."
          }
        },
        "anyOf": [
          {
            "required": [
              "counterPartyId"
            ]
          },
          {
            "required": [
              "counterPartyAddress"
            ]
          }
        ],
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneDiscoveryResponse": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "DiscoveryResponse"
          },
          "profile": {
            "type": "string",
            "description": "The local dataspace profile id that matches a protocol version advertised by the counter party."
          },
          "version": {
            "type": "string",
            "description": "The DSP protocol version shared by the local profile and the counter party entry."
          },
          "counterParty": {
            "$ref": "#/components/schemas/ControlplaneCounterParty"
          },
          "binding": {
            "type": "string",
            "description": "The protocol binding for this match (copied from the counter party version entry)."
          }
        },
        "required": [
          "@type",
          "profile",
          "version",
          "counterParty",
          "binding"
        ]
      },
      "ControlplaneCounterParty": {
        "type": "object",
        "description": "Counter party coordinates for a matched protocol version.",
        "properties": {
          "path": {
            "type": "string",
            "description": "The path under the counter party's base URL where the matching DSP version is exposed, as returned in the well-known versions document."
          },
          "dataServiceEndpoint": {
            "type": "string",
            "description": "The counter party's data service endpoint URL."
          }
        },
        "required": [
          "path"
        ]
      },
      "ControlplanePolicyDefinition": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "PolicyDefinition"
          },
          "@id": {
            "type": "string"
          },
          "policy": {
            "$ref": "#/components/schemas/ControlplanePolicyClass"
          },
          "privateProperties": {
            "type": "object",
            "example": {
              "privateKey": "privateValue"
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "policy"
        ]
      },
      "ControlplanePolicyClass": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "const": "Set"
          },
          "profile": {
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string"
              }
            ]
          },
          "permission": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplanePermission"
            },
            "minItems": 1
          },
          "prohibition": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneProhibition"
            },
            "minItems": 1
          },
          "obligation": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneDuty"
            },
            "minItems": 1
          }
        },
        "required": [
          "@type"
        ]
      },
      "ControlplanePolicyEvaluationPlanRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "PolicyEvaluationPlanRequest"
          },
          "policyScope": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "policyScope"
        ]
      },
      "ControlplanePolicyEvaluationPlan": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "PolicyEvaluationPlan"
          },
          "preValidators": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "postValidators": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "permissionSteps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplanePermissionStep"
            }
          },
          "prohibitionSteps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneProhibitionStep"
            }
          },
          "dutySteps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneDutyStep"
            }
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneRuleStep": {
        "type": "object",
        "properties": {
          "isFiltered": {
            "type": "boolean"
          },
          "filteringReasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "constraintSteps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraintStep"
            }
          },
          "ruleFunctions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": []
      },
      "ControlplanePermissionStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneRuleStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "PermissionStep"
              },
              "dutySteps": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ControlplaneDutyStep"
                }
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneProhibitionStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneRuleStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "ProhibitionStep"
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneDutyStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneRuleStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "DutyStep"
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneConstraintStep": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/ControlplaneAndConstraintStep"
          },
          {
            "$ref": "#/components/schemas/ControlplaneOrConstraintStep"
          },
          {
            "$ref": "#/components/schemas/ControlplaneXoneConstraintStep"
          },
          {
            "$ref": "#/components/schemas/ControlplaneAtomicConstraintStep"
          }
        ]
      },
      "ControlplaneAndConstraintStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneMultiplicityConstraintStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "AndConstraintStep"
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneOrConstraintStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneMultiplicityConstraintStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "OrConstraintStep"
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneXoneConstraintStep": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneMultiplicityConstraintStep"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "XoneConstraintStep"
              }
            }
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneAtomicConstraintStep": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "const": "AtomicConstraintStep"
          },
          "isFiltered": {
            "type": "boolean"
          },
          "filteringReasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "functionName": {
            "type": "string"
          },
          "functionParams": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "@type"
        ]
      },
      "ControlplaneMultiplicityConstraintStep": {
        "type": "object",
        "properties": {
          "constraintSteps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraintStep"
            }
          }
        },
        "required": [
          "constraintSteps"
        ]
      },
      "ControlplanePolicyValidationResult": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "PolicyValidationResult"
          },
          "isValid": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "isValid",
          "errors"
        ]
      },
      "ControlplaneAssociateDataspaceProfile": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "AssociateDataspaceProfile"
          },
          "profiles": {
            "type": "array",
            "items": {
              "type": "string",
              "minItems": 1
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "profiles"
        ]
      },
      "ControlplaneTransferRequest": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TransferRequest"
          },
          "@id": {
            "type": "string"
          },
          "counterPartyAddress": {
            "type": "string"
          },
          "protocol": {
            "type": "string"
          },
          "profile": {
            "type": "string"
          },
          "contractId": {
            "type": "string"
          },
          "transferType": {
            "type": "string"
          },
          "privateProperties": {
            "type": "object"
          },
          "callbackAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneCallbackAddress"
            }
          },
          "dataplaneMetadata": {
            "$ref": "#/components/schemas/ControlplaneDataplaneMetadata"
          }
        },
        "oneOf": [
          {
            "required": [
              "protocol"
            ],
            "not": {
              "required": [
                "profile"
              ]
            }
          },
          {
            "required": [
              "profile"
            ],
            "not": {
              "required": [
                "protocol"
              ]
            }
          }
        ],
        "required": [
          "@context",
          "@type",
          "counterPartyAddress",
          "contractId",
          "transferType"
        ]
      },
      "ControlplaneTransferProcess": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TransferProcess"
          },
          "@id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "CONSUMER",
              "PROVIDER"
            ]
          },
          "state": {
            "type": "string"
          },
          "stateTimestamp": {
            "type": "integer"
          },
          "callbackAddresses": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneCallbackAddress"
            }
          },
          "correlationId": {
            "type": "string"
          },
          "assetId": {
            "type": "string"
          },
          "contractId": {
            "type": "string"
          },
          "transferType": {
            "type": "string"
          },
          "errorDetail": {
            "type": "string"
          },
          "dataplaneMetadata": {
            "$ref": "#/components/schemas/ControlplaneDataplaneMetadata"
          }
        },
        "required": [
          "@context",
          "@type",
          "@id",
          "type",
          "state",
          "stateTimestamp"
        ]
      },
      "ControlplaneTransferState": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "state": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "state"
        ]
      },
      "ControlplaneSuspendTransfer": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "SuspendTransfer"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneTransferSuspend": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "SuspendTransfer"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneTerminateTransfer": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TerminateTransfer"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneTransferTerminate": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "TerminateTransfer"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "ControlplaneSchemaValidatorRegistration": {
        "type": "object",
        "properties": {
          "@context": {
            "$ref": "#/components/schemas/ControlplaneContext"
          },
          "@type": {
            "type": "string",
            "const": "SchemaValidatorRegistration"
          },
          "@id": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "validatedType": {
            "type": "string"
          },
          "schema": {
            "type": "string"
          },
          "profiles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "@context",
          "@type",
          "version",
          "validatedType",
          "schema"
        ]
      },
      "ControlplaneContextSchema": {
        "type": "array",
        "items": {
          "type": "string",
          "items": {
            "type": "string"
          }
        },
        "contains": {
          "const": "https://w3id.org/edc/connector/management/v2"
        }
      },
      "ControlplaneContext": {
        "type": "array",
        "items": {
          "type": "string",
          "items": {
            "type": "string"
          }
        },
        "contains": {
          "const": "https://w3id.org/edc/connector/management/v2"
        }
      },
      "ControlplaneDataplaneMetadata": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "const": "DataplaneMetadata"
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "properties": {
            "type": "object",
            "example": {
              "key": "value"
            }
          },
          "profiles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "@type"
        ]
      },
      "ControlplanePolicy": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/ControlplaneMessageOffer"
          },
          {
            "$ref": "#/components/schemas/ControlplaneOffer"
          },
          {
            "$ref": "#/components/schemas/ControlplaneAgreement"
          }
        ]
      },
      "ControlplaneMessageOffer": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplanePolicyClass"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "Offer"
              },
              "target": {
                "type": "string"
              }
            }
          },
          {
            "anyOf": [
              {
                "required": [
                  "permission"
                ]
              },
              {
                "required": [
                  "prohibition"
                ]
              }
            ]
          }
        ],
        "required": [
          "@type"
        ]
      },
      "ControlplaneOffer": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplanePolicyClass"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "Offer"
              }
            }
          },
          {
            "anyOf": [
              {
                "required": [
                  "permission"
                ]
              },
              {
                "required": [
                  "prohibition"
                ]
              }
            ]
          }
        ],
        "not": {
          "required": [
            "target"
          ]
        }
      },
      "ControlplaneAgreement": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplanePolicyClass"
          },
          {
            "properties": {
              "@type": {
                "type": "string",
                "const": "Agreement"
              },
              "target": {
                "type": "string"
              },
              "assigner": {
                "type": "string"
              },
              "assignee": {
                "type": "string"
              },
              "timestamp": {
                "type": "string",
                "pattern": "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))?"
              }
            }
          },
          {
            "anyOf": [
              {
                "required": [
                  "permission"
                ]
              },
              {
                "required": [
                  "prohibition"
                ]
              }
            ]
          }
        ],
        "required": [
          "@type",
          "target",
          "assignee",
          "assigner"
        ]
      },
      "ControlplaneRule": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/ControlplaneAction"
          },
          "constraint": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraint"
            }
          }
        },
        "required": [
          "action"
        ]
      },
      "ControlplanePermission": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneRule"
          }
        ]
      },
      "ControlplaneProhibition": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneRule"
          }
        ]
      },
      "ControlplaneDuty": {
        "type": "object",
        "allOf": [
          {
            "properties": {
              "action": {
                "$ref": "#/components/schemas/ControlplaneAction"
              },
              "constraint": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ControlplaneConstraint"
                }
              }
            },
            "required": [
              "action"
            ]
          }
        ]
      },
      "ControlplaneAction": {
        "type": "string"
      },
      "ControlplaneConstraint": {
        "type": "object",
        "oneOf": [
          {
            "$ref": "#/components/schemas/ControlplaneLogicalConstraint"
          },
          {
            "$ref": "#/components/schemas/ControlplaneAtomicConstraint"
          }
        ]
      },
      "ControlplaneLogicalConstraint": {
        "type": "object",
        "properties": {
          "and": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraint"
            }
          },
          "andSequence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraint"
            }
          },
          "or": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraint"
            }
          },
          "xone": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ControlplaneConstraint"
            }
          }
        },
        "oneOf": [
          {
            "required": [
              "and"
            ]
          },
          {
            "required": [
              "andSequence"
            ]
          },
          {
            "required": [
              "or"
            ]
          },
          {
            "required": [
              "xone"
            ]
          }
        ]
      },
      "ControlplaneAtomicConstraint": {
        "type": "object",
        "properties": {
          "rightOperand": {
            "$ref": "#/components/schemas/ControlplaneRightOperand"
          },
          "leftOperand": {
            "$ref": "#/components/schemas/ControlplaneLeftOperand"
          },
          "operator": {
            "$ref": "#/components/schemas/ControlplaneOperator"
          }
        },
        "required": [
          "rightOperand",
          "operator",
          "leftOperand"
        ]
      },
      "ControlplaneOperator": {
        "type": "string",
        "enum": [
          "eq",
          "gt",
          "gteq",
          "lteq",
          "hasPart",
          "isA",
          "isAllOf",
          "isAnyOf",
          "isNoneOf",
          "isPartOf",
          "lt",
          "term-lteq",
          "neq"
        ]
      },
      "ControlplaneRightOperand": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "object"
          },
          {
            "type": "array"
          }
        ]
      },
      "ControlplaneLeftOperand": {
        "type": "string"
      },
      "ControlplaneContractOffer": {
        "type": "object",
        "allOf": [
          {
            "$ref": "#/components/schemas/ControlplaneMessageOffer"
          },
          {
            "properties": {
              "assigner": {
                "type": "string"
              }
            }
          }
        ],
        "required": [
          "assigner",
          "target"
        ]
      },
      "ControlplaneCallbackAddress": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "const": "CallbackAddress"
          },
          "transactional": {
            "type": "boolean"
          },
          "uri": {
            "type": "string"
          },
          "events": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "authKey": {
            "type": "string"
          },
          "authCodeId": {
            "type": "string"
          }
        },
        "required": [
          "@type",
          "transactional",
          "uri",
          "events"
        ]
      },
      "IdentityhubAction": {
        "type": "object",
        "properties": {
          "constraint": {
            "$ref": "#/components/schemas/IdentityhubConstraint"
          },
          "includedIn": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubApiErrorDetail": {
        "type": "object",
        "properties": {
          "invalidValue": {
            "type": "object"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubConstraint": {
        "type": "object",
        "discriminator": {
          "propertyName": "edctype"
        },
        "properties": {
          "edctype": {
            "type": "string"
          }
        },
        "required": [
          "edctype"
        ]
      },
      "IdentityhubCreateParticipantContextResponse": {
        "type": "object",
        "properties": {
          "apiKey": {
            "type": "string"
          },
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string"
          }
        }
      },
      "IdentityhubCredentialContainerSchema": {
        "type": "object",
        "example": {
          "credentialType": "MembershipCredential",
          "payload": "",
          "format": "jwt"
        }
      },
      "IdentityhubCredentialDescriptor": {
        "type": "object",
        "properties": {
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubCredentialMessage": {
        "type": "object",
        "example": {
          "@context": [
            "https://w3id.org/dspace-dcp/v1.0/dcp.jsonld"
          ],
          "type": "CredentialMessage",
          "credentials": [
            {
              "credentialType": "MembershipCredential",
              "payload": "",
              "format": "jwt"
            },
            {
              "credentialType": "OrganizationCredential",
              "payload": "",
              "format": "json-ld"
            }
          ],
          "requestId": "requestId"
        },
        "properties": {
          "@context": {
            "type": "object"
          },
          "@type": {
            "type": "string"
          },
          "credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCredentialContainerSchema"
            }
          },
          "requestId": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "@type",
          "credentials",
          "requestId"
        ]
      },
      "IdentityhubCredentialRequestDto": {
        "type": "object",
        "properties": {
          "credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCredentialDescriptor"
            }
          },
          "holderPid": {
            "type": "string"
          },
          "issuerDid": {
            "type": "string"
          }
        },
        "required": [
          "credentials",
          "issuerDid"
        ]
      },
      "IdentityhubCredentialSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubCredentialStatus": {
        "type": "object",
        "properties": {
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubCredentialSubject": {
        "type": "object",
        "properties": {
          "claims": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IdentityhubCriterion": {
        "type": "object",
        "properties": {
          "operandLeft": {
            "type": "object"
          },
          "operandRight": {
            "type": "object"
          },
          "operator": {
            "type": "string"
          }
        }
      },
      "IdentityhubDidContextsRequest": {
        "type": "object",
        "properties": {
          "contextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IdentityhubDidDocument": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "authentication": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "capabilityInvocation": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "service": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubService"
            }
          },
          "verificationMethod": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubVerificationMethod"
            }
          }
        }
      },
      "IdentityhubDidRequestPayload": {
        "type": "object",
        "properties": {
          "did": {
            "type": "string"
          }
        }
      },
      "IdentityhubDuty": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/IdentityhubAction"
          },
          "consequences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubDuty"
            }
          },
          "constraints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubConstraint"
            }
          }
        }
      },
      "IdentityhubFailure": {
        "type": "object",
        "properties": {
          "failureDetail": {
            "type": "string"
          },
          "messages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IdentityhubHealthCheckResult": {
        "type": "object",
        "properties": {
          "component": {
            "type": "string"
          },
          "failure": {
            "$ref": "#/components/schemas/IdentityhubFailure"
          },
          "isHealthy": {
            "type": "boolean"
          }
        }
      },
      "IdentityhubHealthStatus": {
        "type": "object",
        "properties": {
          "componentResults": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubHealthCheckResult"
            }
          },
          "isSystemHealthy": {
            "type": "boolean"
          }
        }
      },
      "IdentityhubHolderCredentialRequestDto": {
        "type": "object",
        "properties": {
          "holderPid": {
            "type": "string"
          },
          "issuerDid": {
            "type": "string"
          },
          "issuerPid": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "typesAndFormats": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubRequestedCredential"
            }
          }
        }
      },
      "IdentityhubIdentityHubParticipantContext": {
        "type": "object",
        "properties": {
          "apiTokenAlias": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "did": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "lastModified": {
            "type": "integer",
            "format": "int64"
          },
          "participantContextId": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "additionalProperties": true
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "state": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "IdentityhubIssuer": {
        "type": "object",
        "properties": {
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IdentityhubJsonObject": {
        "type": "object",
        "additionalProperties": {
          "$ref": "#/components/schemas/IdentityhubJsonValue"
        },
        "properties": {
          "empty": {
            "type": "boolean"
          },
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "IdentityhubJsonValue": {
        "type": "object",
        "properties": {
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "IdentityhubKeyDescriptor": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean"
          },
          "keyGeneratorParams": {
            "type": "object",
            "additionalProperties": true
          },
          "keyId": {
            "type": "string"
          },
          "privateKeyAlias": {
            "type": "string"
          },
          "publicKeyJwk": {
            "type": "object",
            "additionalProperties": true
          },
          "publicKeyPem": {
            "type": "string"
          },
          "resourceId": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "usage": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "sign_credentials",
                "sign_presentation",
                "sign_token"
              ]
            },
            "uniqueItems": true
          }
        }
      },
      "IdentityhubKeyPairResource": {
        "type": "object",
        "properties": {
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "defaultPair": {
            "type": "boolean"
          },
          "groupName": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "keyContext": {
            "type": "string"
          },
          "keyId": {
            "type": "string"
          },
          "participantContextId": {
            "type": "string"
          },
          "privateKeyAlias": {
            "type": "string"
          },
          "rotationDuration": {
            "type": "integer",
            "format": "int64"
          },
          "serializedPublicKey": {
            "type": "string"
          },
          "state": {
            "type": "integer",
            "format": "int32"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "usage": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "sign_credentials",
                "sign_presentation",
                "sign_token"
              ]
            },
            "uniqueItems": true
          },
          "useDuration": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "IdentityhubParticipantManifest": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean"
          },
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "apiKeyAlias": {
            "type": "string"
          },
          "did": {
            "type": "string"
          },
          "keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubKeyDescriptor"
            },
            "uniqueItems": true
          },
          "participantContextId": {
            "type": "string"
          },
          "provisionApiKey": {
            "type": "boolean"
          },
          "provisionStsAccount": {
            "type": "boolean"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "serviceEndpoints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubService"
            },
            "uniqueItems": true
          }
        }
      },
      "IdentityhubPermission": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/IdentityhubAction"
          },
          "constraints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubConstraint"
            }
          },
          "duties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubDuty"
            }
          }
        }
      },
      "IdentityhubPolicy": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "enum": [
              "SET",
              "OFFER",
              "CONTRACT"
            ]
          },
          "assignee": {
            "type": "string"
          },
          "assigner": {
            "type": "string"
          },
          "inheritsFrom": {
            "type": "string"
          },
          "obligations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubDuty"
            }
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubPermission"
            }
          },
          "profiles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "prohibitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubProhibition"
            }
          },
          "target": {
            "type": "string"
          }
        }
      },
      "IdentityhubPresentationDefinitionSchema": {
        "type": "object",
        "example": "{\n  \"comment\": \"taken from https://identity.foundation/presentation-exchange/spec/v2.0.0/#presentation-definition\"\n  \"presentationDefinition\": {\n    \"id\": \"first simple example\",\n    \"input_descriptors\": [\n      {\n        \"id\": \"A specific type of VC\",\n        \"name\": \"A specific type of VC\",\n        \"purpose\": \"We want a VC of this type\",\n        \"constraints\": {\n          \"fields\": [\n            {\n              \"path\": [\n                \"$.type\"\n              ],\n              \"filter\": {\n                \"type\": \"string\",\n                \"pattern\": \"<the type of VC e.g. degree certificate>\"\n              }\n            }\n          ]\n        }\n      }\n    ]\n  }\n}\n"
      },
      "IdentityhubPresentationQueryMessage": {
        "type": "object",
        "example": {
          "@context": [
            "https://w3id.org/dspace-dcp/v1.0/dcp.jsonld",
            "https://identity.foundation/presentation-exchange/submission/v1"
          ],
          "@type": "PresentationQueryMessage",
          "presentationDefinition": null,
          "scope": [
            "org.eclipse.dspace.dcp.vc.type:SomeCredential_0.3.5:write",
            "org.eclipse.dspace.dcp.vc.type:SomeOtherCredential:read",
            "org.eclipse.dspace.dcp.vc.type:ThirdCredential:*"
          ]
        },
        "properties": {
          "@context": {
            "type": "object"
          },
          "@type": {
            "type": "string"
          },
          "presentationDefinition": {
            "$ref": "#/components/schemas/IdentityhubPresentationDefinitionSchema"
          },
          "scope": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "@context",
          "@type"
        ]
      },
      "IdentityhubPresentationResponseMessage": {
        "type": "object",
        "example": {
          "@context": [
            "https://w3id.org/dspace-dcp/v1.0/dcp.jsonld"
          ],
          "@type": "PresentationResponseMessage",
          "presentation": [
            "dsJdh...UMetV"
          ]
        },
        "properties": {
          "@context": {
            "type": "object"
          },
          "presentation": {
            "type": "array",
            "items": {
              "type": "object",
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "$ref": "#/components/schemas/IdentityhubJsonObject"
                }
              ]
            }
          }
        },
        "required": [
          "@context",
          "presentation"
        ]
      },
      "IdentityhubProhibition": {
        "type": "object",
        "properties": {
          "action": {
            "$ref": "#/components/schemas/IdentityhubAction"
          },
          "constraints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubConstraint"
            }
          },
          "remedies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubDuty"
            }
          }
        }
      },
      "IdentityhubQuerySpec": {
        "type": "object",
        "properties": {
          "filterExpression": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCriterion"
            }
          },
          "limit": {
            "type": "integer",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "format": "int32"
          },
          "sortField": {
            "type": "string"
          },
          "sortOrder": {
            "type": "string",
            "enum": [
              "ASC",
              "DESC"
            ]
          }
        }
      },
      "IdentityhubRequestedCredential": {
        "type": "object",
        "properties": {
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IdentityhubScopeMappingRequest": {
        "type": "object",
        "properties": {
          "contextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IdentityhubScopeMappingResponse": {
        "type": "object",
        "properties": {
          "contextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IdentityhubService": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "serviceEndpoint": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubStsTokenErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "error_description": {
            "type": "string"
          }
        }
      },
      "IdentityhubStsTokenResponse": {
        "type": "object",
        "properties": {
          "access_token": {
            "type": "string"
          },
          "expires_in": {
            "type": "integer",
            "format": "int64"
          },
          "token_type": {
            "type": "string"
          }
        }
      },
      "IdentityhubVerifiableCredential": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "credentialSchema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCredentialSchema"
            }
          },
          "credentialStatus": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCredentialStatus"
            }
          },
          "credentialSubject": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IdentityhubCredentialSubject"
            }
          },
          "dataModelVersion": {
            "type": "string",
            "enum": [
              "V_1_1",
              "V_2_0"
            ]
          },
          "description": {
            "type": "string"
          },
          "expirationDate": {
            "type": "string",
            "format": "date-time"
          },
          "id": {
            "type": "string"
          },
          "issuanceDate": {
            "type": "string",
            "format": "date-time"
          },
          "issuer": {
            "$ref": "#/components/schemas/IdentityhubIssuer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IdentityhubVerifiableCredentialContainer": {
        "type": "object",
        "properties": {
          "credential": {
            "$ref": "#/components/schemas/IdentityhubVerifiableCredential"
          },
          "format": {
            "type": "string",
            "enum": [
              "VC1_0_LD",
              "VC1_0_JWT",
              "VC2_0_JOSE",
              "VC2_0_SD_JWT",
              "VC2_0_COSE"
            ]
          },
          "rawVc": {
            "type": "string"
          }
        }
      },
      "IdentityhubVerifiableCredentialManifest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "issuancePolicy": {
            "$ref": "#/components/schemas/IdentityhubPolicy"
          },
          "participantContextId": {
            "type": "string"
          },
          "reissuancePolicy": {
            "$ref": "#/components/schemas/IdentityhubPolicy"
          },
          "verifiableCredentialContainer": {
            "$ref": "#/components/schemas/IdentityhubVerifiableCredentialContainer"
          }
        }
      },
      "IdentityhubVerifiableCredentialResource": {
        "type": "object",
        "properties": {
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "credentialStatus": {
            "type": "string",
            "enum": [
              "INITIAL",
              "REQUESTING",
              "REQUESTED",
              "ISSUING",
              "ISSUED",
              "REVOKED",
              "SUSPENDED",
              "EXPIRED",
              "NOT_YET_VALID",
              "ERROR"
            ],
            "writeOnly": true
          },
          "holderId": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "issuancePolicy": {
            "$ref": "#/components/schemas/IdentityhubPolicy"
          },
          "issuerId": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          },
          "participantContextId": {
            "type": "string"
          },
          "reissuancePolicy": {
            "$ref": "#/components/schemas/IdentityhubPolicy"
          },
          "state": {
            "type": "integer",
            "format": "int32"
          },
          "timeOfLastStatusUpdate": {
            "type": "string",
            "format": "date-time"
          },
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "usage": {
            "type": "string",
            "enum": [
              "Holder",
              "StatusList",
              "IssuanceTracking"
            ]
          },
          "verifiableCredential": {
            "$ref": "#/components/schemas/IdentityhubVerifiableCredentialContainer"
          }
        }
      },
      "IdentityhubVerificationMethod": {
        "type": "object",
        "properties": {
          "controller": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "publicKeyJwk": {
            "type": "object",
            "additionalProperties": true
          },
          "publicKeyMultibase": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IdentityhubVersionRecord": {
        "type": "object",
        "properties": {
          "lastUpdated": {
            "type": "string",
            "format": "date-time"
          },
          "maturity": {
            "type": "string"
          },
          "urlPath": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        }
      },
      "IssuerserviceApiErrorDetail": {
        "type": "object",
        "properties": {
          "invalidValue": {
            "type": "object"
          },
          "message": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceAttestationDefinition": {
        "type": "object",
        "properties": {
          "attestationType": {
            "type": "string"
          },
          "configuration": {
            "type": "object",
            "additionalProperties": true
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "id": {
            "type": "string"
          },
          "lastModifiedAt": {
            "type": "integer",
            "format": "int64"
          },
          "participantContextId": {
            "type": "string"
          }
        }
      },
      "IssuerserviceAttestationDefinitionRequest": {
        "type": "object",
        "properties": {
          "attestationType": {
            "type": "string"
          },
          "configuration": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCreateParticipantContextResponse": {
        "type": "object",
        "properties": {
          "apiKey": {
            "type": "string"
          },
          "clientId": {
            "type": "string"
          },
          "clientSecret": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCredentialDefinition": {
        "type": "object",
        "properties": {
          "additionalContext": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "attestations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "jsonSchema": {
            "type": "string"
          },
          "jsonSchemaUrl": {
            "type": "string"
          },
          "mappings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceMappingDefinition"
            }
          },
          "participantContextId": {
            "type": "string"
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialRuleDefinition"
            }
          },
          "validity": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "IssuerserviceCredentialDefinitionDto": {
        "type": "object",
        "properties": {
          "additionalContext": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "attestations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "jsonSchema": {
            "type": "string"
          },
          "jsonSchemaUrl": {
            "type": "string"
          },
          "mappings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceMappingDefinition"
            }
          },
          "rules": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialRuleDefinition"
            }
          },
          "validity": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "IssuerserviceCredentialOfferDto": {
        "type": "object",
        "properties": {
          "credentials": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "holderId": {
            "type": "string"
          },
          "offerReason": {
            "type": "string"
          }
        },
        "required": [
          "credentials",
          "holderId"
        ]
      },
      "IssuerserviceCredentialRequest": {
        "type": "object",
        "example": {
          "credentialType": "MembershipCredential",
          "format": "vcdm11_jwt"
        },
        "properties": {
          "credentialType": {
            "type": "string"
          },
          "format": {
            "type": "string"
          }
        },
        "required": [
          "credentialType",
          "format"
        ]
      },
      "IssuerserviceCredentialRequestMessage": {
        "type": "object",
        "example": {
          "@context": [
            "https://w3id.org/dspace-dcp/v1.0/dcp.jsonld"
          ],
          "type": "CredentialRequestMessage",
          "credentials": [
            {
              "credentialType": "MembershipCredential",
              "format": "vcdm11_jwt"
            },
            {
              "credentialType": "OrganizationCredential",
              "format": "vcdm11_ld"
            },
            {
              "credentialType": "Iso9001Credential",
              "format": "vcdm20_jose"
            }
          ]
        },
        "properties": {
          "@context": {
            "type": "object"
          },
          "credentials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialRequest"
            }
          }
        },
        "required": [
          "@context",
          "credentials"
        ]
      },
      "IssuerserviceCredentialRuleDefinition": {
        "type": "object",
        "properties": {
          "configuration": {
            "type": "object",
            "additionalProperties": true
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCredentialSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCredentialStatus": {
        "type": "object",
        "properties": {
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCredentialStatusResponse": {
        "type": "object",
        "properties": {
          "credentialId": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCredentialSubject": {
        "type": "object",
        "properties": {
          "claims": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IssuerserviceCriterion": {
        "type": "object",
        "properties": {
          "operandLeft": {
            "type": "object"
          },
          "operandRight": {
            "type": "object"
          },
          "operator": {
            "type": "string"
          }
        }
      },
      "IssuerserviceDidContextsRequest": {
        "type": "object",
        "properties": {
          "contextUrls": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IssuerserviceDidDocument": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "authentication": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "capabilityInvocation": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "string"
          },
          "service": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceService"
            }
          },
          "verificationMethod": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceVerificationMethod"
            }
          }
        }
      },
      "IssuerserviceDidRequestPayload": {
        "type": "object",
        "properties": {
          "did": {
            "type": "string"
          }
        }
      },
      "IssuerserviceFailure": {
        "type": "object",
        "properties": {
          "failureDetail": {
            "type": "string"
          },
          "messages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IssuerserviceHealthCheckResult": {
        "type": "object",
        "properties": {
          "component": {
            "type": "string"
          },
          "failure": {
            "$ref": "#/components/schemas/IssuerserviceFailure"
          },
          "isHealthy": {
            "type": "boolean"
          }
        }
      },
      "IssuerserviceHealthStatus": {
        "type": "object",
        "properties": {
          "componentResults": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceHealthCheckResult"
            }
          },
          "isSystemHealthy": {
            "type": "boolean"
          }
        }
      },
      "IssuerserviceHolder": {
        "type": "object",
        "properties": {
          "anonymous": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "did": {
            "type": "string"
          },
          "holderId": {
            "type": "string"
          },
          "holderName": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "lastModifiedAt": {
            "type": "integer",
            "format": "int64"
          },
          "participantContextId": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "IssuerserviceHolderDto": {
        "type": "object",
        "properties": {
          "did": {
            "type": "string"
          },
          "holderId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "did",
          "holderId"
        ]
      },
      "IssuerserviceIdentityHubParticipantContext": {
        "type": "object",
        "properties": {
          "apiTokenAlias": {
            "type": "string"
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "did": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "lastModified": {
            "type": "integer",
            "format": "int64"
          },
          "participantContextId": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "additionalProperties": true
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "state": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "IssuerserviceIssuanceProcessDto": {
        "type": "object",
        "properties": {
          "claims": {
            "type": "object",
            "additionalProperties": true
          },
          "createdAt": {
            "type": "integer",
            "format": "int64"
          },
          "credentialDefinitions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "credentialFormats": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "enum": [
                "VC1_0_LD",
                "VC1_0_JWT",
                "VC2_0_JOSE",
                "VC2_0_SD_JWT",
                "VC2_0_COSE"
              ]
            }
          },
          "holderId": {
            "type": "string"
          },
          "holderPid": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "participantContextId": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "updatedAt": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "IssuerserviceIssuer": {
        "type": "object",
        "properties": {
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "id": {
            "type": "string"
          }
        }
      },
      "IssuerserviceIssuerMetadata": {
        "type": "object",
        "example": {
          "@context": [
            "https://w3id.org/dspace-dcp/v1.0/dcp.jsonld"
          ],
          "type": "IssuerMetadata",
          "credentialIssuer": "did:web:issuer-url",
          "credentialsSupported": [
            {
              "type": "CredentialObject",
              "credentialType": "MembershipCredential",
              "credentialSchema": "https://example.org/schemas/membership.json",
              "offerReason": "reissue",
              "bindingMethods": [
                "did:web"
              ],
              "profiles": [
                "vc20-bssl/jwt",
                "vc10-sl2021/jwt",
                "..."
              ],
              "issuancePolicy": {
                "id": "Scalable trust example",
                "input_descriptors": [
                  {
                    "id": "pd-id",
                    "constraints": {
                      "fields": [
                        {
                          "path": [
                            "$.vc.type"
                          ],
                          "filter": {
                            "type": "string",
                            "pattern": "^AttestationCredential$"
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        },
        "properties": {
          "@context": {
            "type": "object"
          },
          "credentialIssuer": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "@context",
          "credentialIssuer",
          "status",
          "type"
        ]
      },
      "IssuerserviceJsonObject": {
        "type": "object",
        "additionalProperties": {
          "$ref": "#/components/schemas/IssuerserviceJsonValue"
        },
        "properties": {
          "empty": {
            "type": "boolean"
          },
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "IssuerserviceJsonValue": {
        "type": "object",
        "properties": {
          "valueType": {
            "type": "string",
            "enum": [
              "ARRAY",
              "OBJECT",
              "STRING",
              "NUMBER",
              "TRUE",
              "FALSE",
              "NULL"
            ]
          }
        }
      },
      "IssuerserviceKeyDescriptor": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean"
          },
          "keyGeneratorParams": {
            "type": "object",
            "additionalProperties": true
          },
          "keyId": {
            "type": "string"
          },
          "privateKeyAlias": {
            "type": "string"
          },
          "publicKeyJwk": {
            "type": "object",
            "additionalProperties": true
          },
          "publicKeyPem": {
            "type": "string"
          },
          "resourceId": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "usage": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "sign_credentials",
                "sign_presentation",
                "sign_token"
              ]
            },
            "uniqueItems": true
          }
        }
      },
      "IssuerserviceMappingDefinition": {
        "type": "object",
        "properties": {
          "input": {
            "type": "string"
          },
          "output": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          }
        }
      },
      "IssuerserviceParticipantManifest": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean"
          },
          "additionalProperties": {
            "type": "object",
            "additionalProperties": true
          },
          "apiKeyAlias": {
            "type": "string"
          },
          "did": {
            "type": "string"
          },
          "keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceKeyDescriptor"
            },
            "uniqueItems": true
          },
          "participantContextId": {
            "type": "string"
          },
          "provisionApiKey": {
            "type": "boolean"
          },
          "provisionStsAccount": {
            "type": "boolean"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "serviceEndpoints": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceService"
            },
            "uniqueItems": true
          }
        }
      },
      "IssuerserviceQuerySpec": {
        "type": "object",
        "properties": {
          "filterExpression": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCriterion"
            }
          },
          "limit": {
            "type": "integer",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "format": "int32"
          },
          "sortField": {
            "type": "string"
          },
          "sortOrder": {
            "type": "string",
            "enum": [
              "ASC",
              "DESC"
            ]
          }
        }
      },
      "IssuerserviceService": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "serviceEndpoint": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceStsTokenErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "error_description": {
            "type": "string"
          }
        }
      },
      "IssuerserviceStsTokenResponse": {
        "type": "object",
        "properties": {
          "access_token": {
            "type": "string"
          },
          "expires_in": {
            "type": "integer",
            "format": "int64"
          },
          "token_type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceVerifiableCredential": {
        "type": "object",
        "properties": {
          "@context": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "credentialSchema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialSchema"
            }
          },
          "credentialStatus": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialStatus"
            }
          },
          "credentialSubject": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IssuerserviceCredentialSubject"
            }
          },
          "dataModelVersion": {
            "type": "string",
            "enum": [
              "V_1_1",
              "V_2_0"
            ]
          },
          "description": {
            "type": "string"
          },
          "expirationDate": {
            "type": "string",
            "format": "date-time"
          },
          "id": {
            "type": "string"
          },
          "issuanceDate": {
            "type": "string",
            "format": "date-time"
          },
          "issuer": {
            "$ref": "#/components/schemas/IssuerserviceIssuer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IssuerserviceVerifiableCredentialResourceDto": {
        "type": "object",
        "properties": {
          "credential": {
            "$ref": "#/components/schemas/IssuerserviceVerifiableCredential"
          },
          "format": {
            "type": "string",
            "enum": [
              "VC1_0_LD",
              "VC1_0_JWT",
              "VC2_0_JOSE",
              "VC2_0_SD_JWT",
              "VC2_0_COSE"
            ]
          },
          "id": {
            "type": "string"
          },
          "participantContextId": {
            "type": "string"
          }
        }
      },
      "IssuerserviceVerificationMethod": {
        "type": "object",
        "properties": {
          "controller": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "publicKeyJwk": {
            "type": "object",
            "additionalProperties": true
          },
          "publicKeyMultibase": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      },
      "IssuerserviceVersionRecord": {
        "type": "object",
        "properties": {
          "lastUpdated": {
            "type": "string",
            "format": "date-time"
          },
          "maturity": {
            "type": "string"
          },
          "urlPath": {
            "type": "string"
          },
          "version": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "tags": [
    {
      "name": "API Keys",
      "description": "API key management, self-service, and token exchange"
    },
    {
      "name": "Activity Log",
      "description": "Append-only record of organisation mutations"
    },
    {
      "name": "Dataspace Discovery",
      "description": "Public dataspace directory — cross-organisation discovery of published versions and profiles"
    },
    {
      "name": "Dataspaces",
      "description": "Dataspace registry management within an organisation"
    },
    {
      "name": "EDC",
      "description": "EDC connector and dataspace identity management"
    },
    {
      "name": "Organisations",
      "description": "Organisation registration and management"
    },
    {
      "name": "Platform",
      "description": "Platform-level endpoints such as health and the served OpenAPI specification"
    }
  ]
}