Skip to main content

Associate App Configuration API (v1)

Download OpenAPI specification:Download

Use this API to retrieve and update the current configuration for Associate App set up for your business.

Use this API to enable or disable features such as offline mode, payment and refund options, commerce components in the app, etc. You can also use the API to update general UI settings of the app.

Important: Enabling "new_customer_profile" toggle will disrupt any active custom app extensions that you have configured for customer profile screens in Associate App. This feature is supported from Associate App v1.37.0 and later.

For more information, see Associate App configuration guides.

Associate App retailer configuration

Configure Associate App globally across all stores in your business.

Get Associate App configuration

Returns the current configuration for Associate App in your business.

Important: For more information on the schema properties and how to use them to configure the app, see the guide.

Responses

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Update Associate App configuration

Updates and replaces the current configuration values for Associate App in your business.

Important: Before you use this method to update or replace Associate App configuration, see the guide for instructions.

Note: If no previous configuration for the app existed, use this method to create a new configuration for the app.

If you have specified a store specific Associate App configuration in your business, the store configuration takes precedence over the global configuration for the app.

Authorizations:
newStoreAccessToken
Request Body schema: application/json
non-empty
One of
non-empty
object
required
object
required
object
object
object
object
object
last_published_release
string^\d+\.\d+\.\d+$

Version of the last published Associate App release to identify users on an outdated app.

Responses

Request samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Update Associate App configuration

Updates the current configuration values for Associate App in your business.

Important: Before you use this method to update or replace Associate App configuration, see the guide for instructions.

Authorizations:
newStoreAccessToken
Request Body schema: application/json
non-empty
One of
non-empty
object
required
object
required
object
object
object
object
object
last_published_release
string^\d+\.\d+\.\d+$

Version of the last published Associate App release to identify users on an outdated app.

Responses

Request samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Associate App store configuration

Configure Associate App for specific stores for your business.

Get Associate App configuration for the given store.

Returns the current store configuration for Associate App in your business.

Important: For more information on the schema properties and how to use them to configure the app, see the guide.

Responses

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Update Associate App configuration

Updates and replaces the current store configuration values for Associate App in your business.

Important: Before you use this method to update or replace Associate App configuration, see the guide for instructions.

Authorizations:
newStoreAccessToken
Request Body schema: application/json
non-empty
One of
non-empty
object
required
object
required
object
object
object
object
object
last_published_release
string^\d+\.\d+\.\d+$

Version of the last published Associate App release to identify users on an outdated app.

Responses

Request samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Update Associate App configuration for the given store.

Updates the current configuration values for Associate App in your business.

Important: Before you use this method to update or replace the Associate App configuration, see the guide for instructions.

Authorizations:
newStoreAccessToken
Request Body schema: application/json
non-empty
One of
non-empty
object
required
object
required
object
object
object
object
object
last_published_release
string^\d+\.\d+\.\d+$

Version of the last published Associate App release to identify users on an outdated app.

Responses

Request samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Deletes Associate App configuration for the given store.

Deletes the configuration for Associate App that has been currently specified for the store.

If you have specified a global Associate App configuration for your business, the global configuration is set for the store once you delete the store-specific app configuration.

Authorizations:
newStoreAccessToken
Request Body schema: application/json
non-empty
One of
non-empty
object
required
object
required
object
object
object
object
object
last_published_release
string^\d+\.\d+\.\d+$

Version of the last published Associate App release to identify users on an outdated app.

Responses

Request samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}

Response samples

Content type
application/json
Example
{
  • "capabilities": {
    },
  • "commerce_components": {
    },
  • "return_process_configuration": {
    },
  • "ui_configurations": {
    },
  • "customizations": {
    },
  • "release_toggles": {
    },
  • "external_integration": {},
  • "last_published_release": "string"
}