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.

Requirements

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.

Request

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 '{
	  "Color":"Red",
    "Value":123
}'

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.

Response

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.

Code

Meaning

200

Ok. The request has been successfully fulfilled.

400

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

404

Not Found. The specified collection has not been found.

403

Unauthorized. The specified collection cannot be access through API

Last updated