Skip to content
MCPProductSites and appsPortal

Portal programs: update, delete

The Portal Verbs update, delete as MCP do programs, with inputs, result, refusals and an example.

Reference for Portal, one group of Portal programs.

Portal.update

Changes the given properties of a Portal. Verb page.

Text
do: return await $.Portal.update(input)

Emits Portal.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Portal.
pathstringWhere it is mounted on the Site, /portal by default.
toolsstring[]Developer tools a keyed Offer adds: keys, usage, requests, watches, version and testMode.

Returns

OutputTypeRequiredDescription
portalPortalrequiredThe Portal.

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 $.Portal.update({ id: 'portal_DDBhWh6mF5', path: '/' })"
  }
}

Portal.delete

Deletes a Portal: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
do: return await $.Portal.delete(input)

Emits Portal.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Portal.

Returns

OutputTypeRequiredDescription
portalPortalrequiredThe Portal.

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 $.Portal.delete({ id: 'portal_DDBhWh6mF5' })"
  }
}