Hanzo

Dataset

Package dataset is the per-org dataset plane of /v1/risk: a dataset is a VERSIONED, IMMUTABLE snapshot of one tenant's own event surface, and this is where it is declared, materialised, described,…

Package dataset is the per-org dataset plane of /v1/risk: a dataset is a VERSIONED, IMMUTABLE snapshot of one tenant's own event surface, and this is where it is declared, materialised, described, exported and disposed of.

Base URLhttps://api.hanzo.ai
Operations7
AuthAuthorization: Bearer $HANZO_API_KEY

Specification

Specification pending — no HIP in hanzoai/hips declares capability: dataset yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139.

Four surfaces

SurfaceReaches this capability asCoverage
RESTdataset at its own prefix7 operations
CLIno command reaches it yet — use HTTP or an SDK
SDKDatasetApi in every published client7 methods
MCPtool dataset on https://api.hanzo.ai/v1/mcp7 operations

Quickstart

export HANZO_API_KEY=sk-...   # console.hanzo.ai → API keys

Then the first call — a read that needs nothing but the key. GET /v1/dataset, operation riskDatasets:

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

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
GET /v1/dataset/{name}/exportRead a version's rows back, one page at a time
GET /v1/dataset/{name}/lineageShow where a version's rows came from, and whether that can still be demonstrated
POST /v1/dataset/{name}/materializeMaterialise the declared version into immutable rows
GET /v1/dataset/{name}Describe every version of one dataset
DELETE /v1/dataset/{name}Dispose of one dataset and every version of it
GET /v1/datasetList this org's datasets
POST /v1/datasetDeclare the next version of a dataset

All Hanzo APIs · Interactive reference

How is this guide?

On this page