suo
API reference

List indexes

GET /1/indexes — every index on your account, with its record count and last-write time.

GET /1/indexes

Requires any key type; a search key only lists the indexes it is restricted to (see API keys).

Response

{
	"indexes": [
		{
			"name": "docs",
			"recordCount": 1204,
			"partitionCount": 0,
			"lastWriteAt": 1732550401123,
			"partitionKey": null
		},
		{
			"name": "library",
			"recordCount": 48213,
			"partitionCount": 3120,
			"lastWriteAt": 1732550522004,
			"partitionKey": "userId"
		}
	]
}

Example

curl https://api.usesuo.com/1/indexes \
  -H "x-suo-key: suo_admin_YOUR_KEY"

Creating and deleting an index

There is no create-index route: an index is created the first time you write to it, or the first time you save settings for it. To delete an index entirely, do this from the dashboard's index settings — a destructive action gated behind a confirmation, not exposed as a bare API call.

On this page