Lexicon Garden

at.happyproto.actor.syncAccount

Record the email address on the caller's PDS account with HappyProto, read server-side from their PDS session. The dashboard calls it once after each sign-in. The PDS reports the address only when the sign-in granted it (transition:email or account:email); without one, the last recorded address is kept, and an unconfirmed address never replaces a confirmed one. The address itself is never returned. Customers and staff; anyone else gets recorded = false.

Repository @happyproto.at did:plc:mo7vq4jbioxwafy5zkcc3eux namespace authority
Details · procedure
Kindprocedure
Authorityactor.happyproto.at
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

idempotencyKey

requiredstring

A UUID the client generates once per sign-in and resends on every retry of it.

Output

application/json

emailConfirmed

boolean

Whether the PDS reported the held address as confirmed, when it said.

emailRecorded

boolean

Whether HappyProto now holds an address for the caller: this sign-in's, or the last one recorded.

recorded

requiredboolean

Whether the caller has a HappyProto account to record it against: false for anyone who is neither a customer nor staff.

Errors

AuthRequired

This endpoint requires an authenticated caller.

InvalidRequest

idempotencyKey is missing or not a UUID, or the provisioner refused the request as malformed.

Forbidden

Passed through from the provisioner.

NotFound

Passed through from the provisioner.

InvalidSlug

Passed through from the provisioner.

SlugTaken

Passed through from the provisioner.

NotEntitled

Passed through from the provisioner.

InstanceLimit

Passed through from the provisioner.

NoCapacity

Passed through from the provisioner.

OperationInProgress

Passed through from the provisioner.

Upstream

The provisioner is unreachable, not configured, or answered with an error it does not explain to callers.