Get an artifact
Its metadata and every version, oldest first.
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, 18
Nylorun-Subject?stringThe person an application key acts for
Nylorun-Scopes?stringThe subject's space-separated scopes; required with a subject
The artifact
application/json- response
artifactId*stringkind*string"file""folder"name*stringcontentType*stringThe latest version's media type
sessionId?stringagentId?stringlatestVersion*integer0 < valuelabels?audience?"model""model"createdAt*stringupdatedAt*stringversions?array<>import { createClient } from "@nylorun/agents";const client = await createClient();const artifact = await client.artifacts.get("art_123");{ "artifactId": "string", "kind": "file", "name": "string", "contentType": "string", "sessionId": "string", "agentId": "string", "latestVersion": 1, "labels": { "property1": "string", "property2": "string" }, "audience": "model", "createdAt": "string", "updatedAt": "string", "versions": [ { "version": 1, "size": 0, "sha256": "string", "contentType": "string", "source": "upload", "createdAt": "string" } ]}List artifacts GET
Without limit, the existing metadata list, oldest first. Explicit limit (1–200) opts into metadata pages ordered by creation time and artifact ID descending, with an opaque nextCursor bound to the Tenant and filters. sessionId selects only that session's artifacts, excluding Tenant-owned artifacts. Paged reads support kind and repeated label=key=value equality filters. An application key as itself sees all artifacts, including Tenant-owned; a caller acting for a person sees only their sessions' artifacts of allowed agents. Authorization is checked on every page. Newer inserts appear on a fresh traversal, not in pages already passed.
Delete an artifact DELETE
Deletes every version and its bytes; its links stop working. A session's artifact gets `artifact.deleted` in its history. An Agent's disk versions are deleted through `/v1/agents/{agentId}/versions/{version}` (`409` here).