Skip to main content

Manage Entries

Create, read, update, and delete datastore entries from the Dashboard, REST API, or MCP tools.

From the Dashboard​

  1. Navigate to Datastore in the sidebar
  2. Click New Entry to create an entry
  3. Fill in the key, value (JSON), and optionally a namespace, description, and TTL
  4. Click Save

You can filter entries by namespace using the dropdown and search by key prefix using the search field. Click any entry to edit or delete it.

From the REST API​

List entries​

curl "https://app.hooklistener.com/api/v1/datastore?namespace=default&prefix=config:&page=1&page_size=20" \
  -H "Authorization: Bearer hklst_your_api_key"

Get an entry​

curl https://app.hooklistener.com/api/v1/datastore/entries/config:api:timeout \
  -H "Authorization: Bearer hklst_your_api_key"

Create or update an entry​

The upsert endpoint creates the entry if it doesn't exist, or updates the value, description, and expiration if it does.

curl -X PUT https://app.hooklistener.com/api/v1/datastore/entries \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "entry": {
      "key": "config:api:timeout",
      "namespace": "production",
      "value": 30,
      "description": "API request timeout in seconds",
      "ttl_seconds": 86400
    }
  }'

Delete an entry​

curl -X DELETE "https://app.hooklistener.com/api/v1/datastore/entries/config:api:timeout?namespace=production" \
  -H "Authorization: Bearer hklst_your_api_key"

List namespaces​

curl https://app.hooklistener.com/api/v1/datastore/namespaces \
  -H "Authorization: Bearer hklst_your_api_key"

See the full Datastore API reference for request/response details.

From MCP tools​

The Hooklistener MCP server provides four datastore tools:

  • set_datastore_key — create or update an entry
  • get_datastore_key — retrieve an entry by key
  • delete_datastore_key — delete an entry
  • list_datastore_keys — list entries with optional namespace and prefix filters

See MCP Available Tools for full parameter details.

What's next​