fyi.opensocial.finishAccountMove

Finish moving the account the caller signed in to move: with the code its server emailed, the host has its server sign the operation that gives its identity to this host, then finishes as completeImport does, and gives its tokens back.

Details · procedure
Kindprocedure
Authorityopensocial.fyi
Indexed

Procedure

procedure · POST

Input

application/json

code

requiredstring

The code the account's server emailed.

  • maxLength: 64

Output

application/json

address

requiredstring

Its address here: one label under this host's handle domain.

did

requiredstring · did

handle

requiredstring · handle

members

requiredstring

meta

requiredstring

Errors

NotFound

No account is signed in for the caller to move.

NotStarted

Its move is not started (startAccountMove).

UpstreamFailure

The account's server failed, or refused the code.

SignInAgain

The account's sign-in at its server has lapsed, with no way to renew it: sign in to it again.

Similar lexicons

semantic match

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

  • Start moving the account the caller signed in to move (getAccountMove) here, to become a group they run: the host asks its server for its token for this host, copies it as importAccount does, brings its spaces as importAccountSpace takes them, and asks its server to email the code that lets its identity move (finishAccountMove). Started again, it starts over.

  • Finish moving an account here: send the PLC operation its old server signed, which must give it to this host as importAccount said, switch it on and tell the network, and make the group's spaces with the caller as its admin. Only for whoever started the move.

  • The account the caller signed in to move here from the console (/console/move/login), if any: the host keeps its tokens at its server for them until the move is finished or cancelled, for a day at most. Empty when there is none.

  • Stop moving the account the caller signed in to move: its tokens are given back to its server and forgotten here, and a copy of it not yet finished is discarded.

  • Start moving an account that already exists on the network, on any server, here to become a group: check the account's proof that it hands its DID to this host, make it here switched off with new keys, and copy its whole repo and its files from its server. Answers with the credentials the account's PLC operation should name; once its server has signed one, completeImport finishes the move. The caller becomes the group's admin. Only a did:plc account, and never the caller's own. Starting again fo