rip.pds.account.createAccount

Mint an ephemeral account owned by the calling account. The account is deleted and its identity retired when it expires.

Repository @pds.rip did:plc:w24v65i3bcsxk6mbbgfdukve namespace authority
Details · procedure
Kindprocedure
Authorityaccount.pds.rip
Indexed

Procedure

procedure · POST

Input

application/json

domain

string

Handle domain to mint under, which also selects the identity method. Defaults to the server's first configured domain.

handle

string · handle

Desired handle. A two-word handle under the chosen domain is generated when omitted.

password

string

Password for the new account. One is generated and returned when omitted.

  • minLength: 8
  • maxLength: 256

Output

application/json

password

requiredstring

Shown once. The server does not store it in a recoverable form.

pdsEndpoint

requiredstring · uri

Errors

QuotaExceeded

The caller already holds the maximum number of live accounts.

HandleUnavailable

The requested handle is taken or not valid for the domain.

UnknownDomain

The requested domain is not offered by this server.

OwnerNotEligible

The caller's own identity is hosted here and would expire, orphaning what it mints.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Issue an account on any configured domain, including operator-only and permanent ones, optionally on somebody else's behalf. Bypasses the quota. Operators only.

  • Create an account. Implemented by PDS.

  • Issue a new password for an account the calling account owns. The old password is not recoverable and is replaced outright. Existing sessions on the account are not revoked.

  • Delete an account the caller minted, ahead of its expiry. The identity is retired as it would have been on expiry.