Skip to content

Noun programs: retire, trace

The Noun Verbs retire, trace as MCP do programs, with inputs, result, refusals and an example.

Reference for Noun, one group of Noun programs.

Noun.retire

Retire removes a published Noun from new Versions; its records, its history and every pinned Version keep serving. Verb page.

Text
do: return await $.Noun.retire(input)

Emits Noun.retired.

Inputs

InputTypeRequiredDescription
nounNounrequiredThe Noun to retire.

Returns

OutputTypeRequiredDescription
versionVersionrequiredThe new Version, without the Noun.
nounNounrequiredThe Noun, now retired from new Versions.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Noun.retire({ noun: 'noun_v0akLUrXCN' })"
  }
}

Noun.trace

Trace lists every Verb, Process, Offer, Dashboard and Version that references a Noun, so an edit or a retire shows its reach first. Verb page.

Text
do: return await $.Noun.trace(input)

Emits Noun.traced.

Inputs

InputTypeRequiredDescription
nounNounrequiredThe Noun to trace.

Returns

OutputTypeRequiredDescription
usesjsonrequiredEach referencing entry, by kind and id, with the published Versions that serve it.
nounNounrequiredThe Noun traced.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Noun.trace({ noun: 'noun_v0akLUrXCN' })"
  }
}