NylorunDocsBeta
Runtime APIArtifacts

Delete an artifact

DELETE
/v1/artifacts/{artifactId}

Deletes every version and its bytes; its links stop working. A session's artifact gets artifact.deleted in its history.

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

Deleted

application/json
  1. response
artifactId*string
deleted*boolean
import { createClient } from "@nylorun/agents";const client = await createClient();await client.artifacts.delete("art_123");
{  "artifactId": "string",  "deleted": true}

Get an artifact GET

Its metadata and every version, oldest first.

Upload a new version of an artifact POST

Streams the body as the artifact's next version, with the same limits as a new artifact. A session's artifact gets `artifact.version.created` in its history.