Parties (single party) [PATCH]

The PATCH request to the /parties/{partyId} endpoint can be used to partially update information of an iSHARE participant in the Participant Registry (name and alsoKnownAs). Only the provided fields will be updated, other fields remain unchanged. The partyId cannot be changed through this operation. To update information stored in claims, use the PATCH method on claims instead.

The PATCH request to the /parties/{partyId} is an OPTIONAL endpoint.

Update party information

patch

Used to partially update information of an iSHARE participant in the Participant Registry. Only the provided fields will be updated, other fields remain unchanged. The party ID cannot be changed through this operation. Server response is an iSHARE signed JSON Web Token. Please refer to the models 'jwtHeader' and 'jwtPayloadPartyToken' which indicate what the decoded response will look like.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth 2.0 authorization based on bearer token. MUST contain “Bearer “ + access token value. Must be provided if restricted endpoints are needed.

Path parameters

partyIdstringRequired

The id of the party whose record must be updated. Can be anyone of the party id from id or alsoKnownAs attributes of that participant. Since all participants are automatically allocated the derived ishare did, that id is always an option to search for a participant.

Example: did:ishare:EU.NL.NTRNL-12345678

Body

application/json

Schema for partial updates to a party. All fields are optional. Only provided fields will be updated. The ID cannot be updated.

namestringOptional

Name of the party.

Example: Example Corporation

alsoKnownAsstring[]Optional

Array of registered party ids of the party with which the party is also identified. Optional, because a party could be identified with only its did:ishare (in the 'id' property).

Example: ["did:ishare:EU.NL.NTRNL-12345678","did:ebsi:LEIXG-724500AZSGBRY55MNS59","did:web:example.com","CoC:123456789"]

Responses

200

OK

application/json

400

Bad Request - Invalid input data

404

Not Found - Party not found

500

Internal Server Error

patch

/parties/{partyId}

HTTPcURLJavaScriptPython

PATCH /parties/{partyId} HTTP/1.1
Host: isharetest.net
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 156

{
  "name": "Example Corporation",
  "alsoKnownAs": [
    "did:ishare:EU.NL.NTRNL-12345678",
    "did:ebsi:LEIXG-724500AZSGBRY55MNS59",
    "did:web:example.com",
    "CoC:123456789"
  ]
}

{
  "partyToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsIng1YyI6WyJNSUlHa0RDQ0JIaWdBd0lCQWdJVUpYckNOdm56eTV5alU5V0ErTmprQzNPekdpSXdEUVlKS29aSWh2Y05BUUVMQlFBd1hURWVNQndHQTFVRUF3d1ZaVWxFUVZObFUwVkJURTlKUkY5SmMzTkRRVWMwTVJrd0Z3WURWUVJoRXhCT1ZGSk9UQzFwVTBoQlVrVlVSVk5VTVJNd0VRWURWUVFLRXdwcFUwaEJVa1ZVWlhOME1Rc3dDUVlEVlFRR0V3SllXREFlRncweU5ERXhNRFl4TkRNeU1URmFGdzB5TnpFeE1EWXhORE15TVRCYU1HNHhDekFKQmdOVkJBWVRBazVNTVNJd0lBWURWUVFLREJsVVpYTjBJRkJoY25ScFkybHdZVzUwSUZKbFoybHpkSEo1TVNJd0lBWURWUVFEREJsVVpYTjBJRkJoY25ScFkybHdZVzUwSUZKbFoybHpkSEo1TVJjd0ZRWURWUVJoREE1T1ZGSk9UQzB4TURBd01EQXdNRENDQVNJd0RRWUpLb1pJaHZjTkFRRUJCUUFEZ2dFUEFEQ0NBUW9DZ2dFQkFMVHNBRWVBVWs5NUI2bHZkZ1hPcjRoekUxTjJRL2E1UmUwcmsvZEJiRmZCTVBEMWN0ekVMeHJ4a0hLSEFKWjBNZmxjOWdPMitYMjdIVkRoUHF3SkZ1ZWg0VTlpend5dnF6czFWRys5U1Fzbnd6V1p5Q1RQNDBsWGx2cUtHMWtyVWlmRjJsRjNMSmVRRml3UmRSd2txZzRPM2dSU2RvTmdFU0hjOVJReVZTMHNPQUhLVlh4em1rS0NON2FTcGE3bVBVQ290SWVSRmIydFV2R1hiNWxOUUJoejdPd01jQW1NVjU4N3V6VWxuZFZLc0EwbU40UGtySWZQWjNWVmVZOHF1clByTHNPWFBYbVJyRjArWFZmcHoyeGJDMDc2M1M1bHI2VWlrNmJhWE9kQ2NWczd0MWIvNzhaTWV0NEMzVzFuS0dFYmVtcGxidjBoYXpMdUdlbExYV2tDQXdFQUFhT0NBalV3Z2dJeE1BNEdBMVVkRHdFQi93UUVBd0lHUURBTUJnTlZIUk1CQWY4RUFqQUFNQjhHQTFVZEl3UVlNQmFBRkxNYVQwSkE2ZGg0bld2Ly9DU3dFTEUwUFBDSk1GY0dDQ3NHQVFVRkJ3RUJCRXN3U1RCSEJnZ3JCZ0VGQlFjd0FZWTdhSFIwY0hNNkx5OWpZVGN1YVhOb1lYSmxkR1Z6ZEM1dVpYUTZPRFEwTWk5bGFtSmpZUzl3ZFdKc2FXTjNaV0l2YzNSaGRIVnpMMjlqYzNBd0VBWURWUjBnQkFrd0J6QUZCZ05WSFNBd0h3WURWUjBsQkJnd0ZnWUlLd1lCQlFVSEF3UUdDaXNHQVFRQmdqY0tBd3d3V3dZSUt3WUJCUVVIQVFNRVR6Qk5NQk1HQmdRQWprWUJCakFKQmdjRUFJNUdBUVlDTURZR0NDc0dBUVVGQndFRERDcFVhR2x6SUdseklIUmxjM1FnWlhObFlXd2dZMlZ5ZEdsbWFXTmhkR1VnWm05eUlIUmxjM1JwYm1jd0hnWUZaNEVNQXdFRUZUQVRFd05PVkZJVEFrNU1EQWd4TURBd01EQXdNRENCeHdZRFZSMGZCSUcvTUlHOE1JRzVvSUcyb0lHemhvR3dhSFIwY0hNNkx5OWpZVGN1YVhOb1lYSmxkR1Z6ZEM1dVpYUTZPRFEwTWk5bGFtSmpZUzl3ZFdKc2FXTjNaV0l2ZDJWaVpHbHpkQzlqWlhKMFpHbHpkRDlqYldROVkzSnNKbWx6YzNWbGNqMURUaVV6UkdWSlJFRlRaVk5GUVV4UFNVUmZTWE56UTBGSE5DVXlRMjl5WjJGdWFYcGhkR2x2Ymtsa1pXNTBhV1pwWlhJbE0wUk9WRkpPVEMxcFUwaEJVa1ZVUlZOVUpUSkRUeVV6UkdsVFNFRlNSVlJsYzNRbE1rTkRKVE5FV0Znd0hRWURWUjBPQkJZRUZGUDZERGMvK2Qya2ZJcm1uSkF1VDc0ODEzY2JNQTBHQ1NxR1NJYjNEUUVCQ3dVQUE0SUNBUUJIcDVXWGk4Vk5vRDBNYzhicnNmS213dXVRbjVhUEdQWWgrejVQY1FXelI0MEh2TzFGZTl2b3laTlp1Vk5xcENFSmNJMDRPZUJlWm9uL2x6WW9URkdTTENTUHBaeTkyaHFmaGE0SnJMa0p2RjAwaTdvSU81SFNjay9KUXhqdWFHdW1xMHVRMDJhQTZtRjNXYjlaV2tyaElvWFJVcFNpZ0c0a01Kc0MyclZkZlhpejZVUGRqdktLNWszYThCSXpmZkc3MGdKRFBqMCtzSXpjcHhacmUrTVBFSW56QkRtUWdrYmtsL1JYNFJEaG5TMWovNEI2VHNoYjJSZW1BM3E2YkFZb045SWhLbGhGdU1kOXovTUlwbkRwU3dIaElyaG5tUlpVLzRDQkVwdGF0NE1VRXRScWkyUUU1SDhQRU1MbFQvNTZwYW5uaW15RnlRTlNJeGJUcHVjSlEzeUkzUElUb0xLZ3pOY2dUVGlpaGFla3R2dHoydWorVWtkbjAwM2ZhekYzTlF2VUU3Y3g5RjdUV0JEbWs0aEdkQS9Qb2ZWQUFUeXAwVHU3a1dMZ3ZoblNNVEc4eWxpZG1ZY3FSVE1GaVNpWGhid0l1QnU4NXl5QWVXSkpvcGpPOUlBVUNxZ3FtTlNCS05WbWhFekViazhtMW9yYkRVZ2grWkFHU2FqZyt3U0FjMWduT2RqMWlKay81TDFDTHlWNmlVYlMvejY1Z2kzN3dTeW1hc2wvcE9nOUpCeGJGU3dpUER1VTY1NGh2WDFpYWpDL0gyS3JER1RXaTVMaGJ6RFRjd0JUbWhjcTZHOVpOeG8rOVlvTmxkdWVsWHAwd1ZJRzJaOU9FZ1kvcUZ2bE5xL1R6RzBSVnVvZ3Ezd2dSbU5sZ3hQU3YyQjlUYTNFREdUbGs0TlZtQT09IiwiTUlJRjJqQ0NBOEtnQXdJQkFnSVVQRzMrVEFueFZPQmNlOU5hUHQ5cFRBZ201UjR3RFFZSktvWklodmNOQVFFTEJRQXdRakVlTUJ3R0ExVUVBd3dWWlVsRVFWTmxVMFZCVEU5SlJGOVRkV0pEUVVjek1STXdFUVlEVlFRS0V3cHBVMGhCVWtWVVpYTjBNUXN3Q1FZRFZRUUdFd0pZV0RBZUZ3MHlNekE0TWpVd09UQXhNekphRncwME9EQTRNalV3T1RBd01EVmFNRjB4SGpBY0JnTlZCQU1NRldWSlJFRlRaVk5GUVV4UFNVUmZTWE56UTBGSE5ERVpNQmNHQTFVRVlSTVFUbFJTVGt3dGFWTklRVkpGVkVWVFZERVRNQkVHQTFVRUNoTUthVk5JUVZKRlZHVnpkREVMTUFrR0ExVUVCaE1DV0Znd2dnSWlNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0SUNEd0F3Z2dJS0FvSUNBUURhblVnTTEvUFF5WE5UWCtVT0xHclpqUzhIYVRXUi9QNHhEOFNNQ1J4T1hIS3pITFFxRVFPdUhEL3crcng5L2JFd3pINHdWZkowbTYvcjU2S09nMHdMVWxWd095aWtPWEdvSVREMnUrVWk5dDI0dFlJa3g4empMRzdWSFZjdzRkWE90OTJzdktZMUx5YnZscHJvV3pUSGxSd29JTzFZUTRoTytyeWJzdy9LRURFWFVia293amxIQVBjd25zT1c2NDM2N0VOK2V6VDFzUzhkekZJeG1HOHFDMkxyTTJzWEpXcXE1dkplRS84NlRmWjJOTU8rQ1V4a2pqN3VQZ2JXMlYvTU9VaFl5QXRHQWp6ZC9Ld09yTE1STVlhWE9JajYxbThSNzFuaC9MVjluOGRuajB3VFFPTlRIaHVNN21kWlF4aHFPZGtMMmNrU3JCV2kzYXRFVlQxT2hCUlg0Rm1taElobVNXdUN0Z3lLaURDSW90eUdBc1gybzY4MTdmZWU0UmR0d2Z3OVE0b04zTkFodG9kNjBpT0FXQXBWdCtCVDV0dmRnR09ZV1BjYk1SNXBHemJwMzhkR1V5dXdZWlY0TEFuSUdTbTV5YXVjTkUyRTJ4clFDYkVlWm00UlBzeDVKbGVXemlways0MmQ3dnF2V0Q4OElRY1ErYlpNMlg0ckpCWk5zMTY2Q2x4K202SG1LeEtBTGViVXRqc3pzZ3lIOGNxMTBkK2s0QW84b0NhT1lqdjJJYUViTWQrZlYvVWY4a1BrelR0S2x0dGRxaWl4b0lxeWNYTUVnQmFTZ2t1YjdYb1E2SzI2dFJQSjB3NVFrdXVoM01LdEdFV2ZXN0VFR21wbkNxak92Ni9yQU1KaU1XeWgxSWdMZ05CVVBQN3phVlBwREF0Qzg4T1NKUUlEQVFBQm80R3NNSUdwTUJJR0ExVWRFd0VCL3dRSU1BWUJBZjhDQVFFd0h3WURWUjBqQkJnd0ZvQVU0dWJYMHA2RFZqTjlES3RPV1dNWUFzK0h4ZFF3R0FZRFZSMGdCQkV3RHpBRkJnTlZIU0F3QmdZRVZSMGdBREFwQmdOVkhTVUVJakFnQmdnckJnRUZCUWNEQWdZSUt3WUJCUVVIQXdRR0Npc0dBUVFCZ2pjS0F3d3dIUVlEVlIwT0JCWUVGTE1hVDBKQTZkaDRuV3YvL0NTd0VMRTBQUENKTUE0R0ExVWREd0VCL3dRRUF3SUJCakFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBWnY1R3VreDBQRXZWUkVJdDhNVGFQZkNINGF3eWlpWXlpMTdoNlI1TExrMXJlcndRc1NTU0hmVnFmdGR3UkYwb2NMcDJQWEpoZTA3NXFWNDA2QzA0Q2phbU5rM2V6OVppTkhDTmpQdGZpZDZvT3hxejFYazhYUGpOWUVsYkFGbVA3ZUtsLzQ0MXZaaEd1ay9SaFhHTnhRYnRvMFExNmc4SVJjR0R2V2dOaHRydEIxRzJ4U210QjFTMnVVcFNhaVpWTk9ya2R6VGhpRUpzZVVSQm9YeFVYSXFwTHlQVFJsNk1NZ1ZhTEdSWVJjM3ZZaWo0QjdNMmhCTjcvY2puR0xzTVZ0Z2JPdjZDVjIxZzJTWG93YmdPcXpCeUg1MVVUUjZPYkhpR2owa1NDQUxHMTRJUVBrelFQaVNwanUrKzlNMmpBalBNM280MjFaT1VETVAyNDZDc3FQWHJUQWJQWEpWVVIvZ2k0dTUza216QzIxMGp2VnE5aEh3ZWx4UU9UUEZobE02RTFDaDRKYjRQUVJMS0RQRmwrNU5XNEZ5MkpBRGp5dXB5VkhuY2RMRXVQeTBQZ0NMMllvMTQ3SFNwUGo0dTdqYzFSbUhVN05PMTJFVjJaQ01mRmxSd2RHdjZpZjhxTzdzLzZscFpKanBQdExFT2JBNXRENGFoYythUE5BaTlXQ2swcGVSbTFLRTVWR0RXS0ZOU05BaUxKTnpQN20yUTZ5OGZPeTM4Y05nRkJoR09GL0tnRUlzVDEwVis1SzVvK3lsVlZ0UFZlUlJFTkV2S085RUxremUwSUhnc1RCLzZjd09pajRweE05SnZhdWowNkdnbGhJaGlJQTZxMGlEVXFCMU1VUjBIemlZOUJzbldZOWtSOGh3VjNPVytuc216dFF3R1ZFdzJralU9IiwiTUlJRmpqQ0NBM2FnQXdJQkFnSVVGajkvM2pHT1JodElwWjk4T0xSdFJIczBBWXN3RFFZSktvWklodmNOQVFFTEJRQXdRVEVkTUJzR0ExVUVBd3dVWlVsRVFWTmxVMFZCVEU5SlJGOVNiMjkwUnpJeEV6QVJCZ05WQkFvVENtbFRTRUZTUlZSbGMzUXhDekFKQmdOVkJBWVRBbGhZTUI0WERUSXpNRGd5TlRBNU1EQTBORm9YRFRRNE1EZ3lOVEE1TURBd05Wb3dRakVlTUJ3R0ExVUVBd3dWWlVsRVFWTmxVMFZCVEU5SlJGOVRkV0pEUVVjek1STXdFUVlEVlFRS0V3cHBVMGhCVWtWVVpYTjBNUXN3Q1FZRFZRUUdFd0pZV0RDQ0FpSXdEUVlKS29aSWh2Y05BUUVCQlFBRGdnSVBBRENDQWdvQ2dnSUJBTDduemt5b0ZYV2cxZ2hkRzZmbnV6dXZBZE1Xc20vSSttWDNEYnozSS9LeXFMZFd0N1hHM09XVlNuaG9zQUQyVzJTWG5sR1hxeHllMGhQdEVna1FJZGVsN0ZuRm9zV1dyc0VPcmF0Z1hsbk00TldwWURLTVdFVllybzdoekhnQ1oxMjZaUFFVTGxzNTJOY3ZwUk04UzNkWmsrWEsxa2YzVmVTMEoyaFVTRkVBWkhMeVhDWGtoVG5VSTdxbzF1cjFUbURXWXNOUXd4REdPdTdDUXlaWWRLSXdLcUk5ZUdzUkxnTTZQUWxnM3ZaQ3JvcE9vZE03bG9UdWlyQ2wzVUt3NEhyR2syY09pQWY0SWQvL2VhVkNhZndraktzSlRRdUFhaHVSejRxTXNIWUEza0RReiswK2hnblI3NHIraUxyKzhscjA0NGdsbmFXSVd2ckVHY2lSUitQZWN0ZnJMT1FRSVc3aGExM2R6V296a1QwYWduVDFMay9DR3JnTlhWcWhvc0dDMHJ1QVFQSTZEY1BOeTJJTk05Smd0Q21Cc1NqTU0xODVGSUJYNEN5MTdtNzNoOXJLalhaTXhiNlR4WDdDSVp5ZXNnQVMwYkJSYjZ4SXBLc1pybHJqRWF6c2pDMlZIUlJXT01KV1lxY1hMRDVaTnpHTVpVcjZUdDJ5Q1VBdGFtZWNEQVRLTjYvR2JzeGUwdEFCTjBwazByeDVpYys0VFhkQnJvTjlPQVpjaEg0dEpDc09DS29uQ3pBcFB4VlRoRE5NeHNvb3lGcTlEbWdYaHlFVU9Pb2VTK0ZyNEZnSCtqU0FObS9sMTc4Smg5ZXBmWFE5Z0UvNmFxUHhZak5TQmdTNjBTMUVWcUNweHcyclQxbVVZZUdmd2liVm01M2l4R3B0UjhrdGU3MG5BZ01CQUFHamZUQjdNQThHQTFVZEV3RUIvd1FGTUFNQkFmOHdId1lEVlIwakJCZ3dGb0FVMkx1Yk5TMWJQKy9oYTh2TURNK2lMcnBwZW93d0dBWURWUjBnQkJFd0R6QUZCZ05WSFNBd0JnWUVWUjBnQURBZEJnTlZIUTRFRmdRVTR1YlgwcDZEVmpOOURLdE9XV01ZQXMrSHhkUXdEZ1lEVlIwUEFRSC9CQVFEQWdFR01BMEdDU3FHU0liM0RRRUJDd1VBQTRJQ0FRQjhqcVlVdzdUditXNFpIMDZQcmFGNnpmZEN4VDAzRGhSQ2h3NFovUW0wWFZTMmdSeVJ3Y01wdFFGRVJoUE5PQTIyMXU5THFveloxYUszQjM1d2tjR0QvZEZKZ0pDSkI5NlNNdHRRbDJIcC9FaVF6OVBGRjAyZEJTcnVYaElhcmFQYk0rTklHZG15TjJaeXdHR1hJMWFVN0pEM1hHMjlTaDJBQWRPa3Y4ZEk2Z0VnenQvREhTSUliYWtiYUxkRUljN1dCOTVHVUhjSG5OajU4VHpUU3lWZkJtdGIzdkJLOUpHMElvNk5BUFdRWXgyVlA4K2ZJeWxqYTJkMTI4aGdoMGRzRHJYRkFNKzlBWDhoYWU1dnZ4Vmk4VFdzL3oyaW5nK2sraW1tdFNOZnp6S01pTzdyNXdKQWt5and0VUJsQlN0S0lBNlplcjIycG1TVFpaZXVjSGRFVGhhYmNXUWlkVlptTVAzSWY2aXg1VWV5WDhWNk9BdzBnc0kzSVViOTFRNzZkNHNMV2J6b0dOT05BWUZDMUl5ejB4V2o0N1pkNlA3WjJHZmgxVmlJYk14VmlGRGxObWJFWmZscEVTODdLL3loQlVRL3RuQ05HUW9TZHRzdXl1V2czTmZXYnlKb05aemxVOTZKV3hjcVNhWGt6c2U5ajh3YWhheUtOTTZTV0tTWTFaMDVoOEpTY09DbUZCNUY4VjNiZDVuUC91S2phN0g4TzRHT0FBUE0zT3RHK2VxMzd4Vy94TjBvQXNqYnZ0NG9qblViSnMya2lBeEVkd1h4MEs3bWNQZVM3eldtVnQ4aDRSZGNEbS9QR1REYTltOE9xaFF1Y2s4MFFudXhJVVdWcjdHV2FkaDFMeS90bDArYnZta2NuTzJ5YlJKK2dicVJFSERUZTBzeHN3PT0iLCJNSUlGY3pDQ0ExdWdBd0lCQWdJVUN2ZlN2UWVyakZEbU0yTHZtam9URE9JbkxBd3dEUVlKS29aSWh2Y05BUUVMQlFBd1FURWRNQnNHQTFVRUF3d1VaVWxFUVZObFUwVkJURTlKUkY5U2IyOTBSekl4RXpBUkJnTlZCQW9UQ21sVFNFRlNSVlJsYzNReEN6QUpCZ05WQkFZVEFsaFlNQjRYRFRJek1EZ3lOVEE1TURBd05sb1hEVFE0TURneU5UQTVNREF3TlZvd1FURWRNQnNHQTFVRUF3d1VaVWxFUVZObFUwVkJURTlKUkY5U2IyOTBSekl4RXpBUkJnTlZCQW9UQ21sVFNFRlNSVlJsYzNReEN6QUpCZ05WQkFZVEFsaFlNSUlDSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQWc4QU1JSUNDZ0tDQWdFQXhWTUtJOVJNaG5PU0EyTG9yZ0VDM1lETmQyaXRuNzJMT2RmUlJVdTQ1Zkc3MEllditFNGtScnpKMWsyM1dYSDVzSFRiY3NscEVUZUFabmowL3hLQllkRUx1d2U2SFg4a0l3ZDFzNldHbFpjMGw3a2kxZm1qNEhxU3N0R0ovQktHajFhNzIzNld3UEpFV0VIcWZ4OVFNRWV1SktsVVNWRkZ5RTRqTXNmWXA4N2lmSXB1d0U4b0xPdzR5a0RET1A1MlRkMDZ2SENJWXJxREJydnhGZEF1RW5GeE54bFBYUkU0Z0xzeWdnNjJIT3hPdUdtaFdmc3k2VGNjSXA1WElPZGoyQ3plb1hKODJtNS9pbUJQSnZrZWZucmpFUVh6aVNFMm1pMklCRHRHUC9Bd0ZXSTdXcHNFeURYV0ltTVNSMFQzQ3VEbWtlUTE0cE5tY3FNcC9icVgzaTFhZXRhZEZUV3N1aGwwbkgyaVJxS1pESnhabFNjdTk5dG9xNUdyZGNGVWN4R1JReWwrc0ZoVWgzWGNCV0pWN1kyd25GTDJ0WTd0aHRROFpQbXpUTzhrUEtDYkVsNVU2Z0NTSWtwUlBOWkJQRzRkVDBxdSs4QmQ3MVB1N25BeTFpQjRVNnlzMzRjRmxPbEpwR00wRkdyMzVMZWZiUFI4Ymd6Nk05WE5qUmJnTURRY1hETW5maURKN0U4MW9WQnBDWE45eWRIaTFibGhha3VFQmFvYTlNL2themlwR1BtQXV4cldCTW1wMnEwd3pRcDlHUzJlOGtlSklEd0p1eXpFTGFSWkM0eWpWc1ZaUU1LLy9EKzRKM2JvVTVkckNtbW02QzFyd05SZlNadUZHTmNJWURaZUh0ZUdvQ0Y0RUE1amNnZEZhSVlyRGVqNlZBYWI0MnZONUxVQ0F3RUFBYU5qTUdFd0R3WURWUjBUQVFIL0JBVXdBd0VCL3pBZkJnTlZIU01FR0RBV2dCVFl1NXMxTFZzLzcrRnJ5OHdNejZJdXVtbDZqREFkQmdOVkhRNEVGZ1FVMkx1Yk5TMWJQKy9oYTh2TURNK2lMcnBwZW93d0RnWURWUjBQQVFIL0JBUURBZ0VHTUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFCYmNIeVYyYjVtR3dIV3hDU2JEd3I1VjdQZ1NaSUphMXNjckNuSUhEM1oveXhHN1hwNWNJbEJqNE15NGxSSGpadEpWdlVmVGpGcHNFREV2L1BBcTc0T0lvbE4va1BkTWZUY3pGQkdwdnNacjB4MnlVUEVKelFzVFNMeDBnd1ord3ZvS0hXRTBDN0dxZ2tBQk5yRlc4RkxxUnpOcVhzbU01b0k0YzNWNXN5eHdCWUZEVVk1TVBXZHFKRURmUnZqakpQQ1htS09QMWxPK2krRTA3dnNGcER6SFMyRktCNWM2c1RJWmt2dCtIL0NHNGhWdTZadmNGWFh6djJKSy9Fb1ZaNndVZENsdDRwTGdUUVovVzBxUUNKM0dqRmUvUFo3NG1ja1cxeC96azl6MFZRalVwVHF6M0FqUExJamo2MG5NTFRMcDUwb0ZjTUxqdVhzczB2djR0VWpDVHBzMlFnOW4wR3dMbERSNDJOeXcyVEtjTU1CNnljRW9OaVVFdTBsZ2ExSk0wU1ZTc0ZQN0dTVS9XOVZxYXRLN3hwL1hXOS9HRHZncDNaL3BQTTBFM2kxdHFwL25PVTQzWW9mOFdpNEpKNnpPZ1hCenFReE82TUlMWko0cUVmZW5BdEk3bzk1VHk1eWs5dlJib1VzdHl3c2ZDNkNWc3UwOE5ML3R0dzRPU1hPdmJrUSs3ek14Q1lUOVl5UUQ1bC9sdEMzYmdkai9sQlp6bnNCdUdZTk9CMTZ3RE5jR3B1dWFla3NmUWZCRFBIVCt2UjZnUFZGWnB5Vnd5L3R6SDZOVHBVR0Rqb0hWc0N4VWpZODcwT000RDJKY2o5T0lxcWRsa0NvV082aTRWZWM3c1R6eGlYMzlvTlNyMUc3Q29iYzNzWWRobnhnL3ZsZzFCZUNKODdwMEE9PSJdfQ.eyJhdWQiOiJkaWQ6aXNoYXJlOkVVLk5MLk5UUk5MLTEwMDAwMDAxIiwiaXNzIjoiZGlkOmlzaGFyZTpFVS5OTC5OVFJOTC0xMDAwMDAwMCIsInN1YiI6ImRpZDppc2hhcmU6RVUuTkwuTlRSTkwtMTAwMDAwMDAiLCJleHAiOjE3MTkzMjEzNTQsImlhdCI6MTcxOTMyMTMyNCwianRpIjoiYWRmMmU5ZWNkYjk3NGZkNjgyMDljMzkwMDA1YjEyNzYiLCJwYXJ0eUluZm8iOnsiaWQiOiJkaWQ6aXNoYXJlOkVVLk5MLk5UUk5MLTEyMzQ1Njc4IiwibmFtZSI6IkV4YW1wbGUgQ29ycG9yYXRpb24iLCJhbHNvS25vd25BcyI6WyJkaWQ6aXNoYXJlOkVVLk5MLk5UUk5MLTEyMzQ1Njc4IiwiZGlkOmVsc2k6TEVJWEctNzI0NTAwQVpTR0JSWTU1TU5TNTkiLCJkaWQ6d2ViOmV4YW1wbGUuY29tIiwiQ29DOjEyMzQ1Njc4OSJdLCJjbGFpbXMiOlt7ImlkIjoiNWZmYjRiYjktMjAyMC00MDQ1LWE5MjItM2JkODRlNzhmNzA5Iiwic3RhdHVzIjoiYWN0aXZlIiwicmVnaXN0cmFySWQiOiIgZGlkOmlzaGFyZTpFVS5OTC5OVFJOTC0xMDAwMDAwMCIsInN0YXJ0RGF0ZSI6IjIwMjUtMDEtMDFUMDA6MDA6MDAuMDAwWiIsImVuZERhdGUiOiIyMDI2LTEyLTMxVDAwOjAwOjAwLjAwMFoiLCJ0eXBlIjoiZnJhbWV3b3JrQ29tcGxpYW5jZSIsImZyYW1ld29ya0lkIjoiaVNIQVJFIiwiYWRkaXRpb25hbEluZm8iOnsiZGVzY3JpcHRpb24iOiJFeGFtcGxlIGRlc2NyaXB0aW9uIiwicHVibGljbHlQdWJsaXNoYWJsZSI6dHJ1ZSwid2Vic2l0ZSI6Imh0dHBzOi8vd3d3LmV4YW1wbGUuY29tIn19LHsiaWQiOiI5ZWQzNjhmMy02M2NiLTQ2MGEtOGI5ZS1lOTU5YTM0NmNjNDAiLCJzdGF0dXMiOiJhY3RpdmUiLCJyZWdpc3RyYXJJZCI6IiBkaWQ6aXNoYXJlOkVVLk5MLk5UUk5MLTEwMDAwMDAwIiwic3RhcnREYXRlIjoiMjAyNS0wMS0wMVQwMDowMDowMC4wMDBaIiwiZW5kRGF0ZSI6IjIwMjYtMTItMzFUMDA6MDA6MDAuMDAwWiIsInR5cGUiOiJmcmFtZXdvcmtSb2xlIiwicm9sZUlkIjoiU2VydmljZUNvbnN1bWVyIiwidGl0bGUiOiJTZXJ2aWNlIENvbnN1bWVyIiwibG9hIjoibm90LWFwcGxpY2FibGUiLCJjb21wbGlhbmN5VmVyaWZpZWQiOiJ5ZXMiLCJsZWdhbEFkaGVyZW5jZSI6InllcyIsImZyYW1ld29ya0lkIjoiaVNIQVJFIn0seyJpZCI6IjIwNjViMjliLWVjYjgtNDM4Zi1hMTJlLTRmMjM0MDlkNGU1NiIsInN0YXR1cyI6ImFjdGl2ZSIsInJlZ2lzdHJhcklkIjoiIGRpZDppc2hhcmU6RVUuTkwuTlRSTkwtMTAwMDAwMDAiLCJzdGFydERhdGUiOiIyMDI1LTAxLTAxVDAwOjAwOjAwLjAwMFoiLCJlbmREYXRlIjoiMjAyNi0xMi0zMVQwMDowMDowMC4wMDBaIiwidHlwZSI6ImZyYW1ld29ya0FncmVlbWVudCIsImFncmVlbWVudFR5cGUiOiJBY2Nlc3Npb25BZ3JlZW1lbnQiLCJhZ3JlZW1lbnRJZCI6ImZkMDZlMjEzLTdkYjItNDY5Yi1iOWNlLWRlMDBlNDhlMTgxNyIsInRpdGxlIjoiQWNjZXNzaW9uIEFncmVlbWVudCIsInZlcmlmaWNhdGlvbkhhc2giOiJhZWY1YmI1ZTNhYjQ5MTUwYTUzYjg5NjI4YWI4NTkzMzE1YjY2ODZmM2Y5NjQ5NzI3N2ZlYjlkNjU4NTI3YWNiIiwiZnJhbWV3b3JrSWQiOiJpU0hBUkUifSx7ImlkIjoiMjA2NWIyOWItZWNiOC00MzhmLWExMmUtNGYyMzQwOWQ0ZTU2Iiwic3RhdHVzIjoiYWN0aXZlIiwicmVnaXN0cmFySWQiOiIgZGlkOmlzaGFyZTpFVS5OTC5OVFJOTC0xMDAwMDAwMCIsInN0YXJ0RGF0ZSI6IjIwMjUtMDEtMDFUMDA6MDA6MDAuMDAwWiIsImVuZERhdGUiOiIyMDI2LTEyLTMxVDAwOjAwOjAwLjAwMFoiLCJ0eXBlIjoiZnJhbWV3b3JrQWdyZWVtZW50IiwiYWdyZWVtZW50VHlwZSI6IlRlcm1zT2ZVc2UiLCJhZ3JlZW1lbnRJZCI6IjNjZGU2ZmYzLTI0M2QtNDhjMC04MDAzLTMxZDNmZWEzYzFmMSIsInRpdGxlIjoiVGVybXMgb2YgVXNlIiwidmVyaWZpY2F0aW9uSGFzaCI6ImY3MjdhNDU5YjVjYTVhMzJlNWFmZjcxYzAzZmRhYTY5N2NkNDZhNDVlYjA0ZWVjYWFhZTU5MzFlYjlhNWMwMGUiLCJmcmFtZXdvcmtJZCI6ImlTSEFSRSJ9LHsiaWQiOiI4MDhkOTdhYy0yYmIyLTRmZTQtODViNi1iMmMzMTkwMzc1NDEiLCJzdGF0dXMiOiJhY3RpdmUiLCJyZWdpc3RyYXJJZCI6IiBkaWQ6aXNoYXJlOkVVLk5MLk5UUk5MLTEwMDAwMDAwIiwic3RhcnREYXRlIjoiMjAyNS0wMS0wMVQwMDowMDowMC4wMDBaIiwiZW5kRGF0ZSI6IjIwMjYtMTItMzFUMDA6MDA6MDAuMDAwWiIsInR5cGUiOiJ4NTA5Q2VydGlmaWNhdGUiLCJzdWJqZWN0TmFtZSI6IkM9TkwsTz1UZXN0IFNlcnZpY2UgQ29uc3VtZXIsQ049VGVzdCBTZXJ2aWNlIENvbnN1bWVyLDIuNS40Ljk3PU5UUk5MLTEwMDAwMDAxIiwiY2VydGlmaWNhdGVUeXBlIjoiZVNlYWwiLCJ4NWMiOiJNSUlHaURDQ0JIQ2dBd0lCQWdJVVJNSUwrb21nNnY1cFU2cUZPTUZjZUcxWWpEQXdEUVlKS29aSWh2Y05BUUVMQlFBd1hURWVNQndHQTFVRUF3d1ZaVWxFUVZObFUwVkJURTlKUkY5SmMzTkRRVWMwTVJrd0Z3WURWUVJoRXhCT1ZGSk9UQzFwVTBoQlVrVlVSVk5VTVJNd0VRWURWUVFLRXdwcFUwaEJVa1ZVWlhOME1Rc3dDUVlEVlFRR0V3SllXREFlRncweU5ERXhNRFl4TkRRMU5ERmFGdzB5TnpFeE1EWXhORFExTkRCYU1HWXhDekFKQmdOVkJBWVRBazVNTVI0d0hBWURWUVFLREJWVVpYTjBJRk5sY25acFkyVWdRMjl1YzNWdFpYSXhIakFjQmdOVkJBTU1GVlJsYzNRZ1UyVnlkbWxqWlNCRGIyNXpkVzFsY2pFWE1CVUdBMVVFWVF3T1RsUlNUa3d0TVRBd01EQXdNREV3Z2dFaU1BMEdDU3FHU0liM0RRRUJBUVVBQTRJQkR3QXdnZ0VLQW9JQkFRRFlTS092bUI2VXhFYVlPUFQ3QVBnVTRtYXVTaDl2YlBhY0p0TTNhNGNkek44S2lwcGpvV1NiZ3I2SmI0RmM3dEd2Tms2bnZXWkhsSHpBREZlMGFRSUdsOElEaHVxMUJoWEpUeEhaNGtydy82QUViQy9HUmNndEpkY2FubGMzV2tNNXJNRXNvRFJkOGdPdk5Ubkw3bTUyRElXYjNSUzhiQ2l0Vkg2cW4zaG9XU3dYOVhlZVU2SnJHdTFrcDZsZlQxOXUxekpLWnVCYUIwSWE0dXptTStRU2Qxa1U2UGVDWFErdHJFZlZVUWtQOGcvcnpaR25TSDh1N05xaXd3VWZGU2lhVXlxOVA0SXArSzBKQlR0QXVROXhwUTZ3UXh0MGlvRk5GYjlpcG1jM3h4ZWtvd01SeWtaekVkb0hPL3luWTNXNHNiVFNsMmVONEVtZkh6UUdSTEpMQWdNQkFBR2pnZ0kxTUlJQ01UQU9CZ05WSFE4QkFmOEVCQU1DQmtBd0RBWURWUjBUQVFIL0JBSXdBREFmQmdOVkhTTUVHREFXZ0JTekdrOUNRT25ZZUoxci8vd2tzQkN4TkR6d2lUQlhCZ2dyQmdFRkJRY0JBUVJMTUVrd1J3WUlLd1lCQlFVSE1BR0dPMmgwZEhCek9pOHZZMkUzTG1semFHRnlaWFJsYzNRdWJtVjBPamcwTkRJdlpXcGlZMkV2Y0hWaWJHbGpkMlZpTDNOMFlYUjFjeTl2WTNOd01CQUdBMVVkSUFRSk1BY3dCUVlEVlIwZ01COEdBMVVkSlFRWU1CWUdDQ3NHQVFVRkJ3TUVCZ29yQmdFRUFZSTNDZ01NTUZzR0NDc0dBUVVGQndFREJFOHdUVEFUQmdZRUFJNUdBUVl3Q1FZSEJBQ09SZ0VHQWpBMkJnZ3JCZ0VGQlFjQkF3d3FWR2hwY3lCcGN5QjBaWE4wSUdWelpXRnNJR05sY25ScFptbGpZWFJsSUdadmNpQjBaWE4wYVc1bk1CNEdCV2VCREFNQkJCVXdFeE1EVGxSU0V3Sk9UQXdJTVRBd01EQXdNREV3Z2NjR0ExVWRId1NCdnpDQnZEQ0J1YUNCdHFDQnM0YUJzR2gwZEhCek9pOHZZMkUzTG1semFHRnlaWFJsYzNRdWJtVjBPamcwTkRJdlpXcGlZMkV2Y0hWaWJHbGpkMlZpTDNkbFltUnBjM1F2WTJWeWRHUnBjM1EvWTIxa1BXTnliQ1pwYzNOMVpYSTlRMDRsTTBSbFNVUkJVMlZUUlVGTVQwbEVYMGx6YzBOQlJ6UWxNa052Y21kaGJtbDZZWFJwYjI1SlpHVnVkR2xtYVdWeUpUTkVUbFJTVGt3dGFWTklRVkpGVkVWVFZDVXlRMDhsTTBScFUwaEJVa1ZVWlhOMEpUSkRReVV6UkZoWU1CMEdBMVVkRGdRV0JCUmR5VU5QaXdlMldwcnd6WWd2eVorNmZDMW9OREFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBc1hackZHNWFqc0ZOZ1RmbG5iVGZENmFML1cwTzl1eXdRN1ZUVHVyWkhib0hUeERJSUwzR3E5VmovZDB2cEpKZ3JmeXNuUi9NQkhDOWZYb25WOVd1d1NLaG85MW1IcXVVYzd5dGx5RndvQU41Uk9WSVIxUkJoVW9zTUcwSmdUdzVQZ1c5eFhCb2dBWis3RUZEaU03MEJKVXIrb2pxbFoyeVlTMzI0SURDcGdGZTl5U1hpbnpUZzgrZDNqQnNRTEUwSVhuUi8rZE5OdGhIaEFsMUhMZmw2d1o5UmJQcFpncDBBZUNjZEtibjFJZlV6ZVBZTW5SeXVEalJnbm1RWVZZRDMxUWE2OGd4NVlzMXFiL2ZZd1NTcGVFUjBaZjA2UzBleFBVWVNodE93UmxZcWlhMno4TGdONFR1cmR3Y0RjVGlqbWVrRTkrL29TU0lUZWhGcm9BMmVITHNxWXRlOGpRZ0ZCUEVjeTJzeUZ3MVZGRHFUYS9HbkpKa29GQ2Y4alBubG5BSEVGSm1raEFaM3hlUDFEYWczMENQK2FvQ1FWTnlraE81WjczVjZCcE5oZHBnYVlYNEIvUVJlUFVocVVvWWJITGVmQWx5TzdTRlJhaHljVytvNjZLNUd1ZXB0Z3RRMkRycmp2Q3RhQ0c4RXRKY3ppaEFqQk4wT1Fac1FXblU4dm9vTHNzK1JtZmc5TVhUUjhrODVjWVQ5Wk1kVS80NnpsZ0FNSWFKaXp2OGo0ZUhhS2dmUkJCMWd3NzFvVzk3b1c1UUtReDg2MVVyUjF1MERKbVNRU1V3Tllsb3BLVlJuSHZYSldVSXJlT3FMZlNTQi8xdVZRZnZxMFV6c0pLZGVPQ0tSTHBYWGd4QjN3N1MyKzVLRkVUUzd0Y2JaNm1JeFpsSmxoMFZSU3M9IiwieDV0I3MyNTYiOiI0NjcwNTUxNDUxMTEzYjE5NDI1ZjhkNjNjM2Q2Y2U0NDRiNThkZTYwODMxMTAxNzQ4ZTlmYjk3YjNlODc2NmY4In1dfX0.F_XtOQdw_9Ercl7q0n2NhLSm8CR2o35QC-d0Zky7QCwnJsTJRGuVTWC7RVdhqk6sTyd3H2BLnjm8YuzzvCieBeQqajgFoLNisCh2R1KHzJbhyw2UFtrtscfOB14dwwADDyuQ6LL_Lx49-BZ66LvAfR8jcB8Hl6_fBYyx0e9a7oR2JBr5JnKxKiS3lVoxixTS5edn7kp2X8MDF_q_IeO62g__lx5SllhAuIn1mKn6jziRTiQa-rYG6DhrP_n6fXciW_XJlNnOJ_Ao3QohyoDvsDi2ewZUa2wLCbNz_pnnm6D2BgEfHIB9f6Z8XIGUaMfSy6jFPu6N2b0oXEbQ74Cdnw"
}

Request model

The following URL parameter must be used.

• partyId {url}/parties/{partyId} (Required) String. The id of the party who must be fetched. Can be anyone of the party id from id or alsoKnownAs attributes of that participant. Since all participants are automatically allocated the derived ishare did, that id is always an option to search for a participant.

The request must be passed as JWT. The JSON model in the JWT is as follows.

• name String. Root level. (Required) Name of the party.

• alsoKnownAs Array of strings. Contained in partyInfo. Array of registered party ids of the party with which the party is also identified. Optional, because a party could be identified with only its iSHARE-ID (in the 'id' property). When updating alsKnownAs all existing values must also be provided. Implementations should raise an error if any of the existing values are missing (meaning deletion) as Ids in this field cannot be deleted once registered.

Example request

PUT /parties/did%3Aishare%3AEU.NL.NTRLNL-10000001 HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json

{
  "name": "Example Corporation",
  "alsoKnownAs": [
    "did:ishare:EU.NL.NTRNL-12345678",
    "did:ebsi:LEIXG-724500AZSGBRY55MNS59",
    "did:web:example.com",
    "CoC:123456789"
  ]
}

Response model

The response will be equal to the response of the GET request for retrieving a single party. Please refer to the response model as defined here.

Example response

Please also refer to the example response under the GET request definition.