Hanzo
OpenapiKv

Get returns one key's current value and revision.

Get returns one key's current value and revision.

GET /v1/kv/{bucket}/{key}

Addresshttps://api.hanzo.ai/v1/kv/{bucket}/{key}
MethodGET
Operationget_kv_by_bucket_by_key
AuthAuthorization: Bearer $HANZO_API_KEY

Get returns one key's current value and revision. 404 when the bucket does not exist, the key was never written, or its latest revision is a delete.

Request

2 fields.

FieldInTypeRequiredDescription
bucketpathstringyesBucket is the bucket, from the path.
keypathstringyesKey is the key, from the path.

Response

StatusBodyMeaning
200kvEntryok

200 body — 5 fields.

FieldInTypeAlwaysDescription
createdbodystringCreated is when this revision was written, RFC3339.
keybodystringKey is the entry's key.
operationbodystringOperation is what wrote the revision: put, del or purge.
revisionbodyintegerRevision is the entry's revision in the bucket.
valuebodystringValue is the value as UTF-8 text; empty for delete and purge markers.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


KV API · All Hanzo APIs · Interactive reference

How is this guide?

On this page