Token Inspection

Verify cluster access credentials, inspect rate limiting, and check node statistics.

Send a POST with a JSON body to your connection endpoint. The instance ID and both tokens are on your cluster page. Example queries for the SNL field are in the SNL reference tab.

token	Your cluster token
cntoken	Your connection token
SNL	The query string

Failures also return HTTP 200, so check the status field in the JSON, not just the HTTP code. A missing field returns "Missing cluster token", "Missing connection token" or "Missing query".

HTTPS works on every plan. TCP and UDP are available on paid plans.

Want a reusable client instead of a one-off request? Pick Python client or JavaScript client in the language list. It is a small class you paste into your project: it sends the request, checks status and raises on failure. Run it on your server, because the tokens grant access to your cluster.

SNL is the query language you put in the SNL field. A query is an execution mode, then a record selection, then optional clauses. Fields and values are typed on both sides, like str<username>::str<shade>.

FETCH;	Retrieve matching records.
WHERE;	Retrieve records matching one or more combined conditions.
EXIST;	Check whether a record exists. Returns True or False.
INSERT;	Create new records.
UPDATE;	Modify selected fields.
OVERWRITE;	Replace an existing record.
DELETE;	Remove a uniquely identified record.
FREEZE;	Freeze a record. `UNFREEZE;` restores it.

Check whether a record exists

EXIST;
str<username>::str<shade>;

Returns True if the record exists, otherwise False. Use it before creating a record you do not want duplicated.

Fetch selected fields

FETCH;
str<username>::str<john>;
GET(username,email,age);

Filter, sort and paginate

WHERE;
int<age>::int<18>||str<gender>::str<male>;
GET(username,bio,id);
ORDER(DESCEND);
START ? 0; LIMIT ? 500;

Insert a record

INSERT;
{
    "username": "john",
    "email": "john@example.com"
};

Update a field

UPDATE;
str<username>::str<john>;
{
    "email": "new@example.com"
};

Delete a record

DELETE;
str<id>::int<42>;

DELETE only works on unique fields and removes at most one record.

Everything else, including every clause, is in the documentation.