NylorunDocsBeta
Runtime APIArtifacts

List artifacts

GET
/v1/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.

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).

Query Parameters

limit?integer

A page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many

Range1 <= value
cursor?string
sessionId?string

Only artifacts belonging to this session; excludes Tenant-owned artifacts

kind?string
Value in"file""folder"
label?|array<string>

key=value; repeat it for several labels

Header Parameters

Nylorun-Protocol*string

The protocol version, 18

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 artifacts; explicit limit opts into pagination

application/json
  1. 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"        }      ]    }  ]}