Save To Collection

This endpoint can be used to insert or update a document inside a Xenioo Database Collection. Documents inside a collection are specified as pure JSON payloads.


To successfully invoke this endpoint :

  1. A Bot Level Authorization Token must be created and sent in the header.

  2. An active Database package must be active on the target account.

  3. The desired collection must exist and must be flagged as accessible through API.


The following request shows how to insert a new document inside a Xenioo Database Collection:

curl --location --request POST 'https://<API ROUTE>/data/<COLLECTIONNAME>' \
--header 'Authorization: Bearer <BOT AUTH TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{

As long as the supplied JSON payload is valid, it will be inserted in the target collection, regardless of the structure of other existing documents.

If supplied, the _id field will be used to update a specific document. If the document does not exist a new document will be created and assigned the supplied id.


If successful, the unique id of the affected document will be returned.

    "Id":"<the unique id of your data>"

Response Codes

This endpoint will reply with the following standard HTTP codes.




Ok. The request has been successfully fulfilled.


Bad Request. The call does not contain the data required to be fulfilled.


Not Found. The specified collection has not been found.


Unauthorized. The specified collection cannot be access through API

Last updated