Child pages
  • DeleteStore
Skip to end of metadata
Go to start of metadata


The DeleteStore API allows the Account Owner to delete a Store by name, along with all the Documents stored in it.


In apstrata, data & digital assets are persisted in a database container called a Store. Individual data items persisted in a Store are called Documents

All Documents saved in an apstrata Store are secured individually with ACLs (from wikipedia: Access Control Lists), allowing developers to specify the Users and/or Groups that can view, update or delete a Document, or more granularly individual fields within that Document. In addition, apstrata provides a "gate" ACL system per Store, allowing a developer to decide the Users and/or Groups that are permitted globally to create, read, update or delete documents on that Store.

A developer can create any number of Stores (limited only by his apstrata account type) to persist different types of data from his application, this would be dictated by security, scalability or application partitioning reasons. As an example the developer might create a Store called PO for his purchase orders repository and another one called Catalog for his inventory description and images.

Apstrata Stores are transactional, allowing the developer to run reliably Atomic bundles of persistant operations (Create, Read, Update, Delete) that will succeed or fail together.

Upon creation, apstrata accounts are configured with a store named "DefaultStore". An account owner can delete this store and create others if needed. 

As described above, ACL settings on each store specify who can invoke each of the SaveDocument, DeleteDocument, GetFile, and Query services in general. For more specific details about Store configuration parameters, please check the SaveConfiguration API.


Specific Request Parameters

(Refer to Common Request Parameters)





Possible Values

The store name of the store to be deleted.




Specific Response Elements

(Refer to Common Response Elements)

Specific Logical Errors

(Refer to Common Logical Error Codes)



Status Code


Store name is invalid. Please refer to the online documentation for a detailed list of acceptable values



The store was not found



Sample Request

Request URL:[authenticationkey]/DeleteStore?apsws.time=[timestamp]&apsws.authSig=[signature] 

POST parameters: 

Sample Response

Success XML:

<response xmlns="">

Failure XML:

<response xmlns="">

Sample JSON Response

{"response": {
    "metadata": {
        "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "status": "success"



  • No labels