Zum Inhalt
HALOWERK

Agentenwerk

state store

Key-value state for agents that need to survive between calls. Every write carries a time-to-live; the maximum is 30 days and there is no way to store something permanently. Values are opaque JSON up to 64 KB, at most 1000 live keys per namespace. Actions: set, get, list, delete. A get on a missing or expired key answers found=false, it is not an error. The namespace is a plain string chosen by the caller and is not authenticated — anyone who knows it can read it, so do not put secrets in it.

POST https://agent.halowerk.com/v1/state-store

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
actionstringJaWhat to do.
namespacestringJaNamespace the key lives in. Not a secret and not authenticated.
keystringNeinKey. Required for set, get and delete.
valueSiehe SchemaNeinAny JSON value. Required for set. Serialised size must stay under 64 KB.
ttl_secondsintegerNeinLifetime in seconds, at most 30 days.
limitintegerNeinMaximum keys returned by list.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "action",
    "namespace"
  ],
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "set",
        "get",
        "list",
        "delete"
      ],
      "description": "What to do."
    },
    "namespace": {
      "type": "string",
      "minLength": 3,
      "maxLength": 128,
      "description": "Namespace the key lives in. Not a secret and not authenticated."
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Key. Required for set, get and delete."
    },
    "value": {
      "description": "Any JSON value. Required for set. Serialised size must stay under 64 KB."
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2592000,
      "default": 3600,
      "description": "Lifetime in seconds, at most 30 days."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100,
      "description": "Maximum keys returned by list."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "action": "set",
  "namespace": "beispiel",
  "ttl_seconds": 3600,
  "limit": 100
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →