NylorunDocsBeta
Runtime APIArtifacts

List a folder version's files

GET
/v1/artifacts/{artifactId}/versions/{version}/tree

The folder version's manifest: every file's path, size, SHA-256 and media type, sorted by path. A file artifact is a 400.

Authorization

headerAuthorizationBearer <token>

An application key of the Tenant (PUT /v1/tenant/keys/{keyId}), or Studio's key, derived from the admin key. With Nylorun-Subject and Nylorun-Scopes, it acts for that person, narrowed to those scopes. Never accepted from a browser (Origin).

Path Parameters

artifactId*string
version*string

A version number, or latest

Header Parameters

Nylorun-Protocol*string

The protocol version, 8

Nylorun-Subject?string

The person an application key acts for

Nylorun-Scopes?string

The subject's space-separated scopes; required with a subject

Response Body

The files

application/json
  1. response
artifactId*string
version*integer
Range0 < value
entries*array<>
import { createClient } from "@nylorun/agents";const client = await createClient();const tree = await client.artifacts.tree("art_123", { version: 2 });
{  "artifactId": "string",  "version": 1,  "entries": [    {      "path": "string",      "size": 0,      "sha256": "string",      "contentType": "string"    }  ]}