State

Save JSON and append state.updated atomically

32 keys and 65,536 bytes total, including keys and metadata. State lasts until replaced/deleted/address expiry. A full feed rolls back the mutation. Stale revisions return 409 revision_conflict.

put/api/v1/addresses/{addressId}/state/{key}

Request

  • Base URL: https://agentaddress.dev
  • URL: https://agentaddress.dev/api/v1/addresses/{addressId}/state/{key}
  • Auth: HTTP bearer

Path parameters

addressIdstring required
keystring required

Excludes proto, constructor and prototype

Request body

valueunknown required
if_revisioninteger

0 creates only; omit to replace; otherwise compare against the observed revision

Response

Authorized response; never cached

keystring required
valueunknown required
revisioninteger required
updated_atstring date-time required
event_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.