List Keys

Lists keys in a collection with optional pagination and prefix filtering.

Authentication

Requires internal authentication. Pass credentials via X-Glue-Authentication header, or apikey and secret headers.

Path Parameters

Parameter Type Description
col string The name of the collection

Query Parameters

Parameter Type Description
limit integer Maximum number of keys to return (default: 100)
prefix string Filter keys by prefix

Example Request

1curl "https://api.hola.cloud/v1/collections/users/keys?prefix=user:&limit=10" \
2  -H "X-Glue-Authentication: YOUR_AUTH_TOKEN"

Example Response

1HTTP/1.1 200 OK
2Content-Type: application/json
 1{
 2  "items": [
 3    {
 4      "key": "user:1001",
 5      "value": { "name": "Alice" },
 6      "version": 1,
 7      "updatedAt": "2025-06-20T15:30:00Z"
 8    },
 9    {
10      "key": "user:1002",
11      "value": { "name": "Bob" },
12      "version": 1,
13      "updatedAt": "2025-06-21T08:00:00Z"
14    }
15  ],
16  "next": "user:1002"
17}

Error Codes

Status Code Description
403 forbidden Missing authentication headers
500 internal_error Internal server error

Comments

Leave a comment