Skip to main content

​
Overview

Allows the client to apply for a new Legal Identity on the server. The application must be signed using one of the keys created by the client.

​
HTTP request

POST /Agent/Legal/ApplyId

​
Authentication

Requires a valid JWT bearer token.

​
Request (JSON)

{
	"keyId": Required(Str(PKeyId)),
	"nonce": Required(Str(PNonce)),
	"keySignature": Required(Str(PKeySignature)),
	"requestSignature": Required(Str(PRequestSignature)),
	"Properties":
	{
		"name": Required(Str(PPropertyName)),
		"value": Required(Str(PPropertyValue))
	}?[]
}

​
Input parameters

ParameterDescription
PKeyIdIdentity of key to use for signing the Identity application.
PNonceA unique random string, at least 32 characters long, with sufficient entropy to not be reused again. If reused, an error will be returned.
PKeySignatureCryptographic signature of the key ID, using the key password.
PRequestSignatureCryptographic signature of the requesut, using the account password.
PPropertyNameNames of properties that will be engraved into the Legal Identity.
PPropertyValueValues of properties that will be engraved into the Legal Identity.

​
Response (JSON)

{
	"Identity": Required(PIdentity)
}

​
Response parameters

ParameterDescription
PIdentityIdentity object generated by the server.

​
Notes

This endpoint uses the request schema notation described in Pattern matching.