Upload a file as a new artifact
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.
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).
name*stringThe file's name, e.g. brief.pdf
sessionId?stringThe session it belongs to
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 file's bytes; Content-Type is its media type
body*file*/*binaryThe artifact and its first version
application/json- response
artifact*version*import { createClient } from "@nylorun/agents";const client = await createClient();const artifact = await client.artifacts.upload(report, { name: "report.pdf", sessionId: "ses_123",});{ "artifact": { "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" } ] }, "version": { "version": 1, "size": 0, "sha256": "string", "contentType": "string", "source": "upload", "createdAt": "string" }}Download a file an A2A task wrote GET
Where the `url` parts of an A2A task's file artifacts point (Host feature `a2a-profile-v2`, `files/v1`): a file version's bytes, with Range, or a folder version as a zip. Served only to the subject whose session wrote it, as the A2A endpoint is: send the same credential, `Nylorun-Subject` and `Nylorun-Scopes`. Another subject's artifact is a `404`.
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.