Get artifacts

Answers one of the org's objects, as the list does, with an address that fetches its bytes for ten minutes once it is stored: how an executor reads an artifact:<sha256> dataset its job names, and how the org downloads what it uploaded.

GET /v1/train/artifacts/{sha256}

Addresshttps://api.hanzo.ai/v1/train/artifacts/{sha256}
MethodGET
Operationget_train_artifacts_by_sha256
AuthAuthorization: Bearer $HANZO_API_KEY

Answers one of the org's objects, as the list does, with an address that fetches its bytes for ten minutes once it is stored: how an executor reads an artifact:<sha256> dataset its job names, and how the org downloads what it uploaded. Another org's sha256 is not found, exactly as an unknown one is.

Request

1 field.

FieldInTypeRequiredDescription
sha256pathstringyesSHA256 names the object, from the path.

Response

StatusBodyMeaning
200train.Objectok
defaultproblem-detailsrefused

200 body — 10 fields.

FieldInTypeAlwaysDescription
expiresbodyinteger (int64)—Expires is when retention deletes it unless published, unix seconds; absent while it is published, pending, or retention keeps everything.
jobsbodystring[]—Jobs are the jobs that produced or hold it; none for an upload.
kindbodystring—Kind is dataset for an upload, else the output kind a job produced it as.
namebodystring—Name labels it.
publishedbodyboolean—Published says a job of the org has it published.
sha256bodystring—SHA256 names the bytes.
sizebodyinteger (int64)—Size is its byte count.
statebodystring—State is pending until its bytes are read back, then stored.
storedbodyinteger (int64)—Stored is when its bytes were read back, unix seconds.
urlbodystring—URL fetches the bytes for ten minutes, on a read of one stored object.

Failure carries the platform error shape — see Errors.

Examples

hanzo train artifacts get <sha256>
import { Configuration, TrainApi } from 'hanzoai';

const api = new TrainApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getTrainArtifactsBySha256({ sha256: 'sha256' });
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import TrainApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = TrainApi(client).get_train_artifacts_by_sha256(sha256='sha256')
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.TrainAPI.GetTrainArtifactsBySha256(context.Background()).Execute()
if err != nil {
	return err
}
use hanzo_client::apis::{configuration::Configuration, train_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = train_api::get_train_artifacts_by_sha256(&cfg, Default::default()).await?;
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.TrainApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new TrainApi(client).getTrainArtifactsBySha256();
curl https://api.hanzo.ai/v1/train/artifacts/<sha256> \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP reaches train through the train tool, which names its 35 operations with its own verbs — this one among them, under a name only MCP declares. describe explains any of them:

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_train_artifacts"
         }
       }
     }'

Train API · All Hanzo APIs · Interactive reference

Was this page useful?
Broken link or missing step? Drop it in #docs on Discord or open a PR.