NylorunDocsBeta
Runtime APIAgentsDisk versions

Delete an Agent's disk version

DELETE
/v1/agents/{agentId}/versions/{version}

Deletes the version, and the stored files no other version names. Refused while a seed reads it.

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

agentId*string

The Agent id, percent-encoded: users%2Falice%2Ftriage for users/alice/triage

version*string

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

Deleted, or there was none

application/json
  1. response
agentId*string
version*number
deleted*boolean
import { createClient } from "@nylorun/agents";const client = await createClient();await client.agents.deleteVersion("users/alice/assistant", 2);
{  "agentId": "string",  "version": 0,  "deleted": true}

List an Agent's disk versions GET

Newest first. Read a version's tree, files, diff and zip through `/v1/artifacts/{artifactId}/versions/{version}/…`.

List an Agent's triggers GET

Each trigger its manifest declares, with what the Agent holds of it: its status (`active`, `paused` with a reason, `completed` for an `at` that ran), when it runs next and last ran.