NylorunDocsBeta
Runtime APIArtifacts

Get an artifact

GET
/v1/artifacts/{artifactId}

Its metadata and every version, oldest first.

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

Path Parameters

artifactId*string

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 artifact

application/json
  1. response
artifactId*string
kind*string
Value in"file""folder"
name*string
contentType*string

The latest version's media type

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