Users

Save a private address

Changed on

Requires the current unsuspended owner. Delegated credentials require users:write. Success and errors are no-store. The server generates addressId. The body contains label/geography; exactly one valid Idempotency-Key header identifies retries within this owner. Same-key original creation content returns the same entry's current view (201), including after edits. Changed creation content or a deleted entry conflicts. Saving does not synchronously geocode or select a preferred address.

post/api/v1/me/addresses

Request

  • Base URL: https://api.stage.aura-historia.com
  • URL: https://api.stage.aura-historia.com/api/v1/me/addresses
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring required

Opaque owner-scoped creation retry key. Reuse with the original body to recover the server-generated ID. Different keys permit equal-content bookmarks.

Request body

labelstring required

Nonblank private label, at most 128 UTF-8 bytes, without control characters.

Response

Successful private operation.

addressIdstring required

Strict server-generated UUIDv7 UserAddress TypeID, returned on creation. No bare UUID or owner input.

labelstring required

Nonblank private label, at most 128 UTF-8 bytes, without control characters.

inputRevisioninteger required
versioninteger required
preferredboolean required

Changes