POST /register

Requests the registration or update of a mailbox. May be used to update encryption keys. May incur cost. The mailbox identity is given through the keys field in the MailboxMetadata field.

Request

The body of the request must be a MailboxRegistrationRequest.

Details:

interface MailboxRegistrationRequest {

  // Keys to add/update for the mailbox.
  mailbox_metadata: MailboxMetadata;

  // Signature by the mailbox's signing key affirming
  // the update of keys, of purpose
  // TALER_SIGNATURE_MAILBOX_REGISTER.
  // The signature is created over the SHA-512 hash
  // of (encryptionKeyType||encryptionKey||expiration)
  // Base32 crockford-encoded.
  // The signature system is defined through the
  // signing_key_type in the keys field.
  signature: string;

}

Response

204 No Content:

Update/creation complete.

403 Forbidden:

The signature is invalid. This response comes with a standard ErrorDetail response.

402 Payment Required

Client needs to make a Taler payment before proceeding. See standard Taler payment procedure.