Update an Account

Update an Account

curl --request PATCH \
  --url https://demo.spreecommerce.org/api/v2/storefront/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "user": {
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Snow",
    "selected_locale": "fr",
    "bill_address_id": "1",
    "ship_address_id": "1",
    "password": "spree123",
    "password_confirmation": "spree123"
  }
}
'

{
  "data": {
    "id": "1",
    "type": "user",
    "attributes": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Snow",
      "selected_locale": "en",
      "store_credits": 0,
      "completed_orders": 0,
      "tags": [
        "VIP",
        "supplier"
      ],
      "public_metadata": {
        "user_segment": "supplier"
      }
    },
    "relationships": {
      "default_billing_address": {
        "data": {
          "id": "2",
          "type": "address"
        }
      },
      "default_shipping_address": {
        "data": {
          "id": "1",
          "type": "address"
        }
      }
    }
  }
}

PATCH

api

storefront

account

Update an Account

curl --request PATCH \
  --url https://demo.spreecommerce.org/api/v2/storefront/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "user": {
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Snow",
    "selected_locale": "fr",
    "bill_address_id": "1",
    "ship_address_id": "1",
    "password": "spree123",
    "password_confirmation": "spree123"
  }
}
'

{
  "data": {
    "id": "1",
    "type": "user",
    "attributes": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Snow",
      "selected_locale": "en",
      "store_credits": 0,
      "completed_orders": 0,
      "tags": [
        "VIP",
        "supplier"
      ],
      "public_metadata": {
        "user_segment": "supplier"
      }
    },
    "relationships": {
      "default_billing_address": {
        "data": {
          "id": "2",
          "type": "address"
        }
      },
      "default_shipping_address": {
        "data": {
          "id": "1",
          "type": "address"
        }
      }
    }
  }
}

Authorizations

Authorization

string

header

required

User token to authorize Cart and Checkout requests.

It is required to associate Cart with the User.

Body

application/vnd.api+json

user

object

Show child attributes

user.email

string

Example:

"[email protected]"

user.first_name

string

Example:

"John"

user.last_name

string

Example:

"Snow"

user.selected_locale

string

Example:

"fr"

user.bill_address_id

string

Example:

"1"

user.ship_address_id

string

Example:

"1"

user.password

string

Example:

"spree123"

user.password_confirmation

string

Example:

"spree123"

Response

200 Success - Returns the user object.

data

User · object

required

Show child attributes

data.id

string

required

Example:

"1"

data.type

string

default:user

required

data.attributes

object

required

Show child attributes

data.attributes.email

string

Example:

"[email protected]"

data.attributes.first_name

string

Example:

"John"

data.attributes.last_name

string

Example:

"Doe"

data.attributes.selected_locale

string

Example:

"fr"

data.attributes.store_credits

number

Example:

150.75

data.attributes.completed_orders

number

Number of placed Orders by this User

Example:

3

data.attributes.tags

string[]

List of tags associated with the user

data.attributes.public_metadata

object

The public metadata for this User

Example:

{ "user_segment": "supplier" }

data.relationships

object

required

Show child attributes

data.relationships.default_billing_address

object

Default billing address associated with this Account

Show child attributes

data.relationships.default_billing_address.data

object

Show child attributes

data.relationships.default_billing_address.data.id

string

required

data.relationships.default_billing_address.data.type

string

required

data.relationships.default_shipping_address

object

Default shipping address associated with this Account

Show child attributes

data.relationships.default_shipping_address.data

object

Show child attributes

data.relationships.default_shipping_address.data.id

string

required

data.relationships.default_shipping_address.data.type

string

required

included

Address · object[]

Show child attributes

included.id

string

required

Example:

"1"

included.type

string

default:address

required

included.attributes

object

required

Show child attributes

included.attributes.firstname

string

Example:

"John"

included.attributes.lastname

string

Example:

"Doe"

included.attributes.address1

string

Example:

"1600 Amphitheatre Pkwy"

included.attributes.address2

string | null

Example:

"Suite 1"

included.attributes.city

string

Example:

"Mountain View"

included.attributes.zipcode

string

Example:

"94043"

included.attributes.phone

string | null

Example:

"(+1) 123 456 789"

included.attributes.state_name

string

Example:

"California"

included.attributes.state_code

string | null

State abbreviation

Example:

"CA"

included.attributes.country_name

string

Example:

"United States of America"

included.attributes.country_iso3

string

Country ISO3 code

Example:

"USA"

included.attributes.company

string | null

Company name

Example:

"Google Inc."

included.attributes.label

string | null

The internal name for this address (Work, Home)

Example:

"Home"

Create an Account

List all Addresses

⌘I

API basics

Tutorials

Storefront API

Platform API

Authorizations

Body

Response