@twin.org/identity-service 0.0.3-next.9 → 0.9.0

package/docs/open-api/spec.json

@@ -45,6 +45,11 @@
 						"example": "did:iota:tst:0xe3088ba9aa8c28e1d139708a14e8c0fdff11ee8223baac4aa5bcf3321e4bfc6a"
 					}
 				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
 				"responses": {
 					"200": {
 						"description": "Response to resolving an identity.",
@@ -92,6 +97,24 @@
 							}
 						}
 					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -765,35 +788,24 @@
 				}
 			}
 		},
-		"/identity/{identity}/verifiable-credential/{verificationMethodId}": {
+		"/identity/{identity}/alias": {
 			"post": {
-				"operationId": "identityVerifiableCredentialCreate",
-				"summary": "Create an identity verifiable credential",
+				"operationId": "identityAlsoKnownAsCreate",
+				"summary": "Add an alias to the alsoKnownAs property on the document",
 				"tags": [
 					"Identity"
 				],
 				"parameters": [
 					{
 						"name": "identity",
-						"description": "The identity to create the verification credential for.",
-						"in": "path",
-						"required": true,
-						"schema": {
-							"type": "string"
-						},
-						"style": "simple",
-						"example": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a"
-					},
-					{
-						"name": "verificationMethodId",
-						"description": "The verification method id to use.",
+						"description": "The identity to create the alias for.",
 						"in": "path",
 						"required": true,
 						"schema": {
 							"type": "string"
 						},
 						"style": "simple",
-						"example": "my-assertion"
+						"example": "did:iota:tst:0xe3088ba9aa8c28e1d139708a14e8c0fdff11ee8223baac4aa5bcf3321e4bfc6a"
 					}
 				],
 				"security": [
@@ -802,24 +814,17 @@
 					}
 				],
 				"requestBody": {
-					"description": "Request to create a verifiable credential.",
+					"description": "Request to create an alias for an identity.",
 					"required": true,
 					"content": {
 						"application/json": {
 							"schema": {
-								"$ref": "#/components/schemas/IdentityVerifiableCredentialCreateRequest"
+								"$ref": "#/components/schemas/IdentityAlsoKnownAsCreateRequest"
 							},
 							"examples": {
-								"identityVerifiableCredentialCreateRequestExample": {
+								"identityAlsoKnownAsCreateRequestExample": {
 									"value": {
-										"credentialId": "https://example.com/credentials/3732",
-										"subject": {
-											"@context": "https://schema.org",
-											"@type": "Person",
-											"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
-											"name": "Jane Doe"
-										},
-										"revocationIndex": 5
+										"alias": "did:example:123"
 									}
 								}
 							}
@@ -827,44 +832,8 @@
 					}
 				},
 				"responses": {
-					"200": {
-						"description": "Response to creating a verifiable credential.",
-						"content": {
-							"application/json": {
-								"schema": {
-									"$ref": "#/components/schemas/IdentityVerifiableCredentialCreateResponse"
-								},
-								"examples": {
-									"identityVerifiableCredentialCreateResponseExample": {
-										"value": {
-											"verifiableCredential": {
-												"@context": [
-													"https://www.w3.org/2018/credentials/v1",
-													"https://schema.org"
-												],
-												"id": "https://example.com/credentials/3732",
-												"type": [
-													"VerifiableCredential",
-													"Person"
-												],
-												"credentialSubject": {
-													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
-													"name": "Jane Doe"
-												},
-												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
-												"issuanceDate": "2025-01-24T09:21:51.500Z",
-												"credentialStatus": {
-													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
-													"type": "BitstringStatusList",
-													"revocationBitmapIndex": "5"
-												}
-											},
-											"jwt": "eyJraWQiOi...D1Z3AQ"
-										}
-									}
-								}
-							}
-						}
+					"204": {
+						"description": "The rest request ended in success with no data."
 					},
 					"400": {
 						"description": "The server cannot process the request, see the content for more details.",
@@ -926,58 +895,60 @@
 				}
 			}
 		},
-		"/identity/verifiable-credential/verify": {
-			"get": {
-				"operationId": "identityVerifiableCredentialVerify",
-				"summary": "Verify an identity verifiable credential",
+		"/identity/{identity}/alias/{alias}": {
+			"delete": {
+				"operationId": "identityAlsoKnownAsRemove",
+				"summary": "Remove an alias from the alsoKnownAs property on the document",
 				"tags": [
 					"Identity"
 				],
 				"parameters": [
 					{
-						"name": "jwt",
-						"description": "The jwt to verify.",
-						"in": "query",
-						"required": false,
+						"name": "identity",
+						"description": "The identity to remove the alias from.",
+						"in": "path",
+						"required": true,
 						"schema": {
 							"type": "string"
 						},
-						"example": "eyJraWQiOi...D1Z3AQ"
+						"style": "simple",
+						"example": "did:iota:tst:0xe3088ba9aa8c28e1d139708a14e8c0fdff11ee8223baac4aa5bcf3321e4bfc6a"
+					},
+					{
+						"name": "alias",
+						"description": "The alias to remove.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "did:example:123"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
 					}
 				],
 				"responses": {
-					"200": {
-						"description": "Response to verifying a verifiable credential.",
+					"204": {
+						"description": "The rest request ended in success with no data."
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/IdentityVerifiableCredentialVerifyResponse"
+									"$ref": "#/components/schemas/Error"
 								},
 								"examples": {
-									"identityVerifiableCredentialVerifyResponseExample": {
+									"exampleResponse": {
 										"value": {
-											"revoked": false,
-											"verifiableCredential": {
-												"@context": [
-													"https://www.w3.org/2018/credentials/v1",
-													"https://schema.org"
-												],
-												"id": "https://example.com/credentials/3732",
-												"type": [
-													"VerifiableCredential",
-													"Person"
-												],
-												"credentialSubject": {
-													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
-													"name": "Jane Doe"
-												},
-												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
-												"issuanceDate": "2025-01-24T09:21:51.500Z",
-												"credentialStatus": {
-													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
-													"type": "BitstringStatusList",
-													"revocationBitmapIndex": "5"
-												}
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
 											}
 										}
 									}
@@ -985,8 +956,8 @@
 							}
 						}
 					},
-					"400": {
-						"description": "The server cannot process the request, see the content for more details.",
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
 						"content": {
 							"application/json": {
 								"schema": {
@@ -995,11 +966,8 @@
 								"examples": {
 									"exampleResponse": {
 										"value": {
-											"name": "GeneralError",
-											"message": "errorMessage",
-											"properties": {
-												"foo": "bar"
-											}
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
 										}
 									}
 								}
@@ -1027,17 +995,17 @@
 				}
 			}
 		},
-		"/identity/{identity}/verifiable-credential/revoke/{revocationIndex}": {
-			"get": {
-				"operationId": "identityVerifiableCredentialRevoke",
-				"summary": "Revoke an identity verifiable credential",
+		"/identity/{identity}/verifiable-credential/{verificationMethodId}": {
+			"post": {
+				"operationId": "identityVerifiableCredentialCreate",
+				"summary": "Create an identity verifiable credential",
 				"tags": [
 					"Identity"
 				],
 				"parameters": [
 					{
 						"name": "identity",
-						"description": "The identity to revoke the verification credential for.",
+						"description": "The identity to create the verification credential for.",
 						"in": "path",
 						"required": true,
 						"schema": {
@@ -1047,15 +1015,15 @@
 						"example": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a"
 					},
 					{
-						"name": "revocationIndex",
-						"description": "The revocation index to revoke.",
+						"name": "verificationMethodId",
+						"description": "The verification method id to use.",
 						"in": "path",
 						"required": true,
 						"schema": {
 							"type": "string"
 						},
 						"style": "simple",
-						"example": "5"
+						"example": "my-assertion"
 					}
 				],
 				"security": [
@@ -1063,9 +1031,70 @@
 						"jwtBearerAuthScheme": []
 					}
 				],
+				"requestBody": {
+					"description": "Request to create a verifiable credential.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/IdentityVerifiableCredentialCreateRequest"
+							},
+							"examples": {
+								"identityVerifiableCredentialCreateRequestExample": {
+									"value": {
+										"credentialId": "https://example.com/credentials/3732",
+										"subject": {
+											"@context": "https://schema.org",
+											"@type": "Person",
+											"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+											"name": "Jane Doe"
+										},
+										"revocationIndex": 5
+									}
+								}
+							}
+						}
+					}
+				},
 				"responses": {
-					"204": {
-						"description": "The rest request ended in success with no data."
+					"200": {
+						"description": "Response to creating a verifiable credential.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityVerifiableCredentialCreateResponse"
+								},
+								"examples": {
+									"identityVerifiableCredentialCreateResponseExample": {
+										"value": {
+											"verifiableCredential": {
+												"@context": [
+													"https://www.w3.org/2018/credentials/v1",
+													"https://schema.org"
+												],
+												"id": "https://example.com/credentials/3732",
+												"type": [
+													"VerifiableCredential",
+													"Person"
+												],
+												"credentialSubject": {
+													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+													"name": "Jane Doe"
+												},
+												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
+												"issuanceDate": "2025-01-24T09:21:51.500Z",
+												"credentialStatus": {
+													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
+													"type": "BitstringStatusList",
+													"revocationBitmapIndex": "5"
+												}
+											},
+											"jwt": "eyJraWQiOi...D1Z3AQ"
+										}
+									}
+								}
+							}
+						}
 					},
 					"400": {
 						"description": "The server cannot process the request, see the content for more details.",
@@ -1127,16 +1156,389 @@
 				}
 			}
 		},
-		"/identity/{identity}/verifiable-credential/unrevoke/{revocationIndex}": {
-			"get": {
-				"operationId": "identityVerifiableCredentialUnrevoke",
-				"summary": "Unrevoke an identity verifiable credential",
+		"/identity/verifiable-credential/verify/document": {
+			"post": {
+				"operationId": "identityVerifiableCredentialVerifyDocument",
+				"summary": "Verify an identity verifiable credential document",
 				"tags": [
 					"Identity"
 				],
-				"parameters": [
+				"security": [
 					{
-						"name": "identity",
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Request to verify a verifiable credential.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "https://schema.twindev.org/w3c-did/DidVerifiableCredential"
+							},
+							"examples": {
+								"identityVerifiableCredentialVerifyDocumentRequestExample": {
+									"value": {
+										"@context": [
+											"https://www.w3.org/2018/credentials/v1",
+											"https://schema.org"
+										],
+										"id": "https://example.com/credentials/3732",
+										"type": [
+											"VerifiableCredential",
+											"Person"
+										],
+										"credentialSubject": {
+											"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+											"name": "Jane Doe"
+										},
+										"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
+										"issuanceDate": "2025-01-24T09:21:51.500Z",
+										"credentialStatus": {
+											"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
+											"type": "BitstringStatusList",
+											"revocationBitmapIndex": "5"
+										}
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"200": {
+						"description": "Response to verifying a verifiable credential.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityVerifiableCredentialVerifyResponse"
+								},
+								"examples": {
+									"identityVerifiableCredentialVerifyResponseExample": {
+										"value": {
+											"revoked": false,
+											"verifiableCredential": {
+												"@context": [
+													"https://www.w3.org/2018/credentials/v1",
+													"https://schema.org"
+												],
+												"id": "https://example.com/credentials/3732",
+												"type": [
+													"VerifiableCredential",
+													"Person"
+												],
+												"credentialSubject": {
+													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+													"name": "Jane Doe"
+												},
+												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
+												"issuanceDate": "2025-01-24T09:21:51.500Z",
+												"credentialStatus": {
+													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
+													"type": "BitstringStatusList",
+													"revocationBitmapIndex": "5"
+												}
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/identity/verifiable-credential/verify": {
+			"get": {
+				"operationId": "identityVerifiableCredentialVerify",
+				"summary": "Verify an identity verifiable credential",
+				"tags": [
+					"Identity"
+				],
+				"parameters": [
+					{
+						"name": "jwt",
+						"description": "The jwt to verify.",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "eyJraWQiOi...D1Z3AQ"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to verifying a verifiable credential.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityVerifiableCredentialVerifyResponse"
+								},
+								"examples": {
+									"identityVerifiableCredentialVerifyResponseExample": {
+										"value": {
+											"revoked": false,
+											"verifiableCredential": {
+												"@context": [
+													"https://www.w3.org/2018/credentials/v1",
+													"https://schema.org"
+												],
+												"id": "https://example.com/credentials/3732",
+												"type": [
+													"VerifiableCredential",
+													"Person"
+												],
+												"credentialSubject": {
+													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+													"name": "Jane Doe"
+												},
+												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
+												"issuanceDate": "2025-01-24T09:21:51.500Z",
+												"credentialStatus": {
+													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
+													"type": "BitstringStatusList",
+													"revocationBitmapIndex": "5"
+												}
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/identity/{identity}/verifiable-credential/revoke/{revocationIndex}": {
+			"get": {
+				"operationId": "identityVerifiableCredentialRevoke",
+				"summary": "Revoke an identity verifiable credential",
+				"tags": [
+					"Identity"
+				],
+				"parameters": [
+					{
+						"name": "identity",
+						"description": "The identity to revoke the verification credential for.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a"
+					},
+					{
+						"name": "revocationIndex",
+						"description": "The revocation index to revoke.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "5"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"204": {
+						"description": "The rest request ended in success with no data."
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/identity/{identity}/verifiable-credential/unrevoke/{revocationIndex}": {
+			"get": {
+				"operationId": "identityVerifiableCredentialUnrevoke",
+				"summary": "Unrevoke an identity verifiable credential",
+				"tags": [
+					"Identity"
+				],
+				"parameters": [
+					{
+						"name": "identity",
 						"description": "The identity to unrevoke the verification credential for.",
 						"in": "path",
 						"required": true,
@@ -1377,6 +1779,161 @@
 				}
 			}
 		},
+		"/identity/verifiable-presentation/verify/document": {
+			"post": {
+				"operationId": "identityVerifiablePresentationVerifyDocument",
+				"summary": "Verify an identity verifiable presentation document",
+				"tags": [
+					"Identity"
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"requestBody": {
+					"description": "Request to verify a verifiable presentation.",
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "https://schema.twindev.org/w3c-did/DidVerifiablePresentation"
+							},
+							"examples": {
+								"identityVerifiablePresentationVerifyDocumentRequestExample": {
+									"value": {
+										"@context": [
+											"https://www.w3.org/2018/credentials/v1",
+											"https://schema.org"
+										],
+										"id": "https://example.com/credentials/3732",
+										"type": [
+											"VerifiableCredential",
+											"Person"
+										],
+										"verifiableCredential": [
+											{
+												"@context": [
+													"https://www.w3.org/2018/credentials/v1",
+													"https://schema.org"
+												],
+												"id": "https://example.com/credentials/3732",
+												"type": [
+													"VerifiableCredential",
+													"Person"
+												],
+												"credentialSubject": {
+													"id": "did:entity-storage:0x4757993355b921a8229bd780f30921b6a0216a72e6c3f37a09d13b8426a17def",
+													"name": "Jane Doe"
+												},
+												"issuer": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a",
+												"issuanceDate": "2025-01-24T09:21:51.500Z",
+												"credentialStatus": {
+													"id": "did:entity-storage:0x879c31386f992cfa29b77fe31e37256d69f6a57653cee4eb60ad4c4613c5515a#revocation",
+													"type": "BitstringStatusList",
+													"revocationBitmapIndex": "5"
+												}
+											}
+										]
+									}
+								}
+							}
+						}
+					}
+				},
+				"responses": {
+					"200": {
+						"description": "Response to verifying a verifiable presentation.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/IdentityVerifiablePresentationVerifyResponse"
+								},
+								"examples": {
+									"identityVerifiablePresentationVerifyResponseExample": {
+										"value": {
+											"revoked": false,
+											"verifiablePresentation": {
+												"@context": [
+													"https://www.w3.org/2018/credentials/v1",
+													"https://schema.org"
+												],
+												"id": "presentationId",
+												"type": [
+													"VerifiablePresentation",
+													"Person"
+												],
+												"verifiableCredential": [
+													"eyJraWQiOi...D1Z3AQ"
+												],
+												"holder": "did:entity-storage:0xcea318e06e89f3fb4048160770effd84d0cfa5801fee13dfa6f9413a00429cec"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/identity/verifiable-presentation/verify": {
 			"get": {
 				"operationId": "identityVerifiablePresentationVerify",
@@ -1396,6 +1953,11 @@
 						"example": "eyJraWQiOi...D1Z3AQ"
 					}
 				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
 				"responses": {
 					"200": {
 						"description": "Response to verifying a verifiable presentation.",
@@ -1450,6 +2012,24 @@
 							}
 						}
 					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -1556,7 +2136,7 @@
 									"identityProofCreateResponseExample": {
 										"value": {
 											"@context": [
-												"https://www.w3.org/ns/credentials/v2",
+												"https://w3id.org/security/data-integrity/v2",
 												"https://www.w3.org/ns/credentials/examples/v2"
 											],
 											"type": "DataIntegrityProof",
@@ -1638,6 +2218,11 @@
 				"tags": [
 					"Identity"
 				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
 				"requestBody": {
 					"description": "Request to verify a proof.",
 					"required": true,
@@ -1669,7 +2254,7 @@
 											}
 										},
 										"proof": {
-											"@context": "https://www.w3.org/ns/credentials/v2",
+											"@context": "https://w3id.org/security/data-integrity/v2",
 											"type": "DataIntegrityProof",
 											"cryptosuite": "eddsa-jcs-2022",
 											"created": "2025-01-24T11:32:13.106Z",
@@ -1722,6 +2307,24 @@
 							}
 						}
 					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
 					"500": {
 						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
 						"content": {
@@ -1832,7 +2435,7 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/ConflictResponse"
+									"$ref": "#/components/schemas/Error"
 								},
 								"examples": {
 									"exampleResponse": {
@@ -2256,13 +2859,18 @@
 						"example": "role,email,name"
 					}
 				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
 				"responses": {
 					"200": {
 						"description": "Response to get an identity public profile.",
 						"content": {
 							"application/ld+json": {
 								"schema": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
+									"$ref": "#/components/schemas/IdentityProfileGetPublicResponse"
 								},
 								"examples": {
 									"identityGetPublicResponseExample": {
@@ -2306,6 +2914,24 @@
 							}
 						}
 					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
 					"404": {
 						"description": "The resource you tried to access does not exist, see the content for more details.",
 						"content": {
@@ -2489,25 +3115,18 @@
 		}
 	},
 	"components": {
-		"schemas": {
-			"ConflictResponse": {
-				"type": "object",
-				"additionalProperties": false,
-				"properties": {
-					"conflicts": {
-						"type": "array",
-						"items": {
-							"type": "string"
-						},
-						"description": "The conflicting items."
-					},
+		"schemas": {
+			"Error": {
+				"description": "Model to describe serialized error.",
+				"type": "object",
+				"properties": {
 					"name": {
 						"type": "string",
 						"description": "The name for the error."
 					},
 					"message": {
 						"type": "string",
-						"description": "The message for the error."
+						"description": "The message for the error as an i18n key."
 					},
 					"source": {
 						"type": "string",
@@ -2527,46 +3146,22 @@
 					}
 				},
 				"required": [
-					"conflicts",
-					"message",
-					"name"
-				],
-				"description": "The body which contains the error."
+					"name",
+					"message"
+				]
 			},
-			"Error": {
+			"IdentityAlsoKnownAsCreateRequest": {
 				"type": "object",
 				"properties": {
-					"name": {
-						"type": "string",
-						"description": "The name for the error."
-					},
-					"message": {
-						"type": "string",
-						"description": "The message for the error."
-					},
-					"source": {
-						"type": "string",
-						"description": "The source of the error."
-					},
-					"properties": {
-						"type": "object",
-						"additionalProperties": {},
-						"description": "Any additional information for the error."
-					},
-					"stack": {
+					"alias": {
 						"type": "string",
-						"description": "The stack trace for the error."
-					},
-					"cause": {
-						"$ref": "#/components/schemas/Error"
+						"description": "The alias to create for the identity."
 					}
 				},
 				"required": [
-					"name",
-					"message"
+					"alias"
 				],
-				"additionalProperties": false,
-				"description": "Model to describe serialized error."
+				"description": "The data for the request."
 			},
 			"IdentityCreateRequest": {
 				"type": "object",
@@ -2576,7 +3171,6 @@
 						"description": "The optional namespace to create the identity in."
 					}
 				},
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityProfileCreateRequest": {
@@ -2589,27 +3183,20 @@
 						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
 					}
 				},
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
+			"IdentityProfileGetPublicResponse": {},
 			"IdentityProfileGetResponse": {
 				"type": "object",
 				"properties": {
 					"identity": {
 						"type": "string",
 						"description": "The identity of the profile, this is the authenticated user identity."
-					},
-					"publicProfile": {
-						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
-					},
-					"privateProfile": {
-						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
 					}
 				},
 				"required": [
 					"identity"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityProfileListResponse": {
@@ -2623,15 +3210,11 @@
 								"identity": {
 									"type": "string",
 									"description": "The identity."
-								},
-								"publicProfile": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
 								}
 							},
 							"required": [
 								"identity"
-							],
-							"additionalProperties": false
+							]
 						},
 						"description": "The identities."
 					},
@@ -2643,7 +3226,6 @@
 				"required": [
 					"items"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityProfileUpdateRequest": {
@@ -2656,7 +3238,6 @@
 						"$ref": "https://schema.twindev.org/json-ld/JsonLdDocument"
 					}
 				},
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityProofCreateRequest": {
@@ -2673,7 +3254,6 @@
 					"proofType",
 					"document"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityProofVerifyRequest": {
@@ -2690,7 +3270,6 @@
 					"document",
 					"proof"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityProofVerifyResponse": {
@@ -2703,7 +3282,6 @@
 				"required": [
 					"verified"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityServiceCreateRequest": {
@@ -2747,7 +3325,6 @@
 					"type",
 					"endpoint"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityVerifiableCredentialCreateRequest": {
@@ -2767,12 +3344,25 @@
 					"expirationDate": {
 						"type": "string",
 						"description": "The date the verifiable credential is valid until."
+					},
+					"jwtHeaderFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT when creating the verifiable credential in jwt format."
+					},
+					"jwtPayloadFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT payload when creating the verifiable credential in jwt format."
 					}
 				},
 				"required": [
 					"subject"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityVerifiableCredentialCreateResponse": {
@@ -2790,7 +3380,6 @@
 					"verifiableCredential",
 					"jwt"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityVerifiableCredentialVerifyResponse": {
@@ -2807,7 +3396,6 @@
 				"required": [
 					"revoked"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityVerifiablePresentationCreateRequest": {
@@ -2848,15 +3436,28 @@
 						},
 						"description": "The verifiable credentials to include in the presentation."
 					},
-					"expiresInMinutes": {
-						"type": "number",
-						"description": "The expiration time for the presentation."
+					"expirationDate": {
+						"type": "string",
+						"description": "The expiration date/time for the presentation."
+					},
+					"jwtHeaderFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT header when creating the verifiable presentation in jwt format."
+					},
+					"jwtPayloadFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT payload when creating the verifiable presentation in jwt format."
 					}
 				},
 				"required": [
 					"verifiableCredentials"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
 			"IdentityVerifiablePresentationCreateResponse": {
@@ -2874,7 +3475,6 @@
 					"verifiablePresentation",
 					"jwt"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityVerifiablePresentationVerifyResponse": {
@@ -2898,7 +3498,6 @@
 				"required": [
 					"revoked"
 				],
-				"additionalProperties": false,
 				"description": "The response payload."
 			},
 			"IdentityVerificationMethodCreateRequest": {
@@ -2915,297 +3514,20 @@
 				"required": [
 					"verificationMethodType"
 				],
-				"additionalProperties": false,
 				"description": "The data for the request."
 			},
-			"JsonLdDocument": {
-				"type": "object",
-				"properties": {
-					"@context": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
-							}
-						]
-					},
-					"@id": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					},
-					"@included": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					},
-					"@graph": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdValueObject"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
-							},
-							{
-								"type": "array",
-								"items": {
-									"anyOf": [
-										{
-											"$ref": "https://schema.twindev.org/json-ld/JsonLdValueObject"
-										},
-										{
-											"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
-										}
-									]
-								}
-							}
-						]
-					},
-					"@nest": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					},
-					"@type": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					},
-					"@reverse": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					},
-					"@index": {
-						"anyOf": [
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-							},
-							{
-								"type": "array",
-								"items": {
-									"$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
-								}
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
-							},
-							{
-								"$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
-							}
-						]
-					}
-				},
-				"additionalProperties": false
-			},
 			"NotFoundResponse": {
 				"type": "object",
-				"additionalProperties": false,
 				"properties": {
 					"notFoundId": {
 						"type": "string",
 						"description": "The id if the item that was not found."
-					},
-					"name": {
-						"type": "string",
-						"description": "The name for the error."
-					},
-					"message": {
-						"type": "string",
-						"description": "The message for the error."
-					},
-					"source": {
-						"type": "string",
-						"description": "The source of the error."
-					},
-					"properties": {
-						"type": "object",
-						"additionalProperties": {},
-						"description": "Any additional information for the error."
-					},
-					"stack": {
-						"type": "string",
-						"description": "The stack trace for the error."
-					},
-					"cause": {
-						"$ref": "#/components/schemas/Error"
 					}
 				},
-				"required": [
-					"message",
-					"name"
+				"allOf": [
+					{
+						"$ref": "#/components/schemas/Error"
+					}
 				],
 				"description": "The body which contains the error."
 			}