Documentation
Documentation
    • English (United States)
Space
Close API Documentation
Space

Spaces store configurations and data. We recommend to use a space per webshop. It is not possible to share data between spaces.

If you want to have different configuration inside the space then use space views (for example different payment methods for different country stores).

When to use space views?

If you have one webshop that sells into different countries using the same database, then you should use the concept of space views.

When to use different spaces?

In case you have completely separated webshops that have a different database, then use two different spaces.

States
  • Create
    The create state indicates that the Space is in creation.
  • Active
    The active state indicates that the Space is active and may be used.
  • Inactive
    The inactive state indicates that the Space is inactive and may not be used.
  • Deleting
    The deleting state indicates that the Space is in the process to be deleted.
  • Deleted
    The deleted state marks the entity for purging from the database.
Properties
  • Account
    The account that the space belongs to.
  • Active
    Whether this space and all its parent accounts are active.
  • Active Or Restricted Active
    Whether this space and all its parent accounts are active or restricted active.
  • Created By
    The ID of the user the space was created by.
  • Created On
    The date and time when the space was created.
  • Database
    The database the space is connected to and that holds the space's data.
  • Deleted By
    The ID of the user the space was deleted by.
  • Deleted On
    The date and time when the space was deleted.
  • ID
    A unique identifier for the object.
  • Last Modified Date
    The date and time when the object was last modified.
  • Name
    The name used to identify the space.
  • Planned Purge Date
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
  • Postal Address
    The address that is used in communication with clients for example in emails, documents, etc.
  • Primary Currency
    The currency that is used to display aggregated amounts in the space.
  • Request Limit
    The maximum number of API requests that are accepted within two minutes. This limit can only be changed with special privileges.
  • Restricted Active
    Whether this space and all its parent accounts are active or restricted active. There is least one parent account that is restricted active.
  • State
    The object's current state.

    A Space can have the following states:

    Active

    When the state is set to Active you are able to access and use all the configurations you set up for this specific space and its corresponding space views.

    Inactive

    When the state is set to Inactive all the corresponding configurations in this space are ignored. However, all the information is not deleted and you can reactivate the space at any moment.

    Deleting

    The space is in the process of deletion. This may take some time until the space is marked as Deleting before being marked as Deleted.

    Deleted

    The space is deleted. Since the space is linked with data which cannot be deleted immediately, we need to keep the space until all the data can be removed.

  • Technical Contact Addresses
    The email address that will receive messages about technical issues and errors that occur in the space.
  • Time Zone
    The time zone that is used to schedule and run background processes. This does not affect the formatting of dates in the user interface.
  • Version
    The version is used for optimistic locking and incremented whenever the object is updated.