NylorunDocsBeta
Runtime APIArtifacts

List artifacts

GET
/v1/artifacts

Oldest first: of one session, or of every session the caller reaches (an application key: every artifact).

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

sessionId?string

Only this session's

Header Parameters

Nylorun-Protocol*string

The protocol version, 8

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

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",      "latestVersion": 1,      "labels": {        "property1": "string",        "property2": "string"      },      "createdAt": "string",      "updatedAt": "string",      "versions": [        {          "version": 1,          "size": 0,          "sha256": "string",          "contentType": "string",          "source": "upload",          "createdAt": "string"        }      ]    }  ]}