{"uid":"cap_m3DmmdC_zGbOIxoFAasy_","slug":"td-agent-utility-state-put-persistent-key-value-store-710d2346","name":"TD Agent Utility – State Put (Persistent Key-Value Store)","description":"Independent website and deployment verification for AI agents: HTTP, DNS, TLS and Chromium screenshot evidence. Three deterministic tools, x402 V2 Base USDC.","url":"https://tdagentutility.co.uk/v1/state-put?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"key":"","tool":"state_put","version":0,"warnings":[],"checked_at":"2026-10-15T00:00:00Z","created_at":0,"expires_at":0,"size_bytes":0,"updated_at":0,"result_status":"PASS"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NOi7YECoizNwce7FPQY46","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a versioned key-value state entry with TTL metadata, returning a status record with timestamps, size, version, and result status.","exampleAgentPrompt":"Save the deployment verification result for 'mysite.co.uk' under the key 'deploy-check-2024' using the state_put tool — I need it stored with a version number so I can retrieve it later and check whether it's still fresh.","exampleUseCases":[{"title":"Persist deployment check between pipeline steps","prompt":"After you run the HTTP and TLS checks on staging.acme.com, store the combined result under the key 'staging-deploy-v3' so the next step in my pipeline can retrieve it without re-running the checks."},{"title":"Save agent workflow checkpoint","prompt":"At the end of this verification run, write the current pass/fail status and timestamp to remote state under the key 'nightly-check-run-42' — I want a version-tracked record I can audit tomorrow."},{"title":"Cache tool output for cross-agent sharing","prompt":"Store the DNS verification output for api.example.com under the key 'dns-verify-api' using state_put, so my reporting agent can pull it later and see when it was last checked and whether it passed."}],"resultDescription":"Returns a JSON object with the stored key name, tool identifier ('state_put'), version number, size_bytes of the stored value, ISO-8601 checked_at timestamp, Unix integer created_at/updated_at/expires_at timestamps, a result_status string (e.g. 'PASS'), and a warnings array listing any non-fatal issues.","failureModes":["Missing or empty key returns validation error","Payload too large exceeds size_bytes limit","Payment failure (x402) blocks the write","Malformed JSON body returns 400","Key collision on version mismatch may return conflict error","Expired or invalid USDC payment causes rejection"],"whenToPreferThis":"Use this endpoint when an AI agent needs to persist intermediate state, checkpoint results, or share data across agent steps within the TD Agent Utility ecosystem — particularly when the stored data is related to website/deployment verification results and you need versioned, timestamped, expiry-aware storage billed per-call via x402 USDC micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:38:40.706Z","isFirstParty":false,"canonicalSlug":"td-agent-utility-state-put-persistent-key-value-store-710d2346"}