Key-Value Store for AI Agent State

cURL

curl -X PUT "https://www.agent-utils.com/v1/kv/state/last-seen" \
  -H "x-agent-id: poller" -H "x-api-key: agutil_agt_…" \
  -H "content-type: application/json" \
  -d '{
    "value": { "event_id": "evt_42" },
    "ttl_seconds": 86400
  }'

Python

import requests

resp = requests.put(
    "https://www.agent-utils.com/v1/kv/state/last-seen",
    headers={
        "x-agent-id": "poller",
        "x-api-key": "agutil_agt_…",
        "content-type": "application/json",
    },
    json={
        "value": {"event_id": "evt_42"},
        "ttl_seconds": 86400,
    },
)
assert resp.status_code == 200

JavaScript

const res = await fetch("https://www.agent-utils.com/v1/kv/state/last-seen", {
  method: "PUT",
  headers: {
    "x-agent-id": "poller",
    "x-api-key": "agutil_agt_…",
    "content-type": "application/json",
  },
  body: JSON.stringify({
    value: { event_id: "evt_42" },
    ttl_seconds: 86400,
  }),
});