Mint a capability link
A short-lived path that downloads one version, with Range, with no other credential: for <img> tags, UIs and sharing. Signed by the Runtime with the Tenant's signing key; at most 15 minutes; it opens nothing once the artifact is deleted. A folder's link opens its zip, or with file that one file.
AuthorizationBearer <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).
artifactId*stringNylorun-Protocol*stringThe protocol version, 8
Nylorun-Subject?stringThe person an application key acts for
Nylorun-Scopes?stringThe subject's space-separated scopes; required with a subject
application/json- body
requestId?string1 <= lengthversion?integer0 < valueexpiresIn?integer1 <= value <= 900file?string1 <= length <= 1024The link
application/json- response
path*stringartifactId*stringversion*integer0 < valuefile?stringexpiresAt*stringimport { createClient } from "@nylorun/agents";const client = await createClient();const link = await client.artifacts.link("art_123", { expiresIn: 3600 });{ "path": "string", "artifactId": "string", "version": 1, "file": "string", "expiresAt": "string"}Download a folder version as a zip GET
Streams the folder's files as one zip archive (deflated, UTF-8 names), read from the Object store as it goes. A file artifact is a `400`.
Open a capability link GET
Downloads the version the link names, with Range, until it expires (`401 token_expired`): a file, a folder's file, or a folder's zip. Needs no credential and no `Nylorun-Protocol`.