List artifacts
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.
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).
limit?integerA page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many
1 <= valuecursor?stringsessionId?stringOnly artifacts belonging to this session; excludes Tenant-owned artifacts
kind?string"file""folder"label?|array<string>key=value; repeat it for several labels
Nylorun-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 artifacts; explicit limit opts into pagination
application/json- response
artifacts*array<>import { createClient } from "@nylorun/agents";const client = await createClient();const artifacts = await client.artifacts.list({ sessionId: "ses_123" });{ "artifacts": [ { "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" } ] } ]}Upload a file as a new artifact POST
Streams the body to the Object store in one request, up to the Tenant's per-file limit and within its total; a body past either stores nothing (`413 limit_exceeded`). Its `Content-Type` is the file's media type (default: from the name). Acting for a person, the artifact belongs to one of their sessions. A session's artifact appears in its history as `artifact.created`.
Get an artifact GET
Its metadata and every version, oldest first.