Book a demo

delete_view

Delete a saved view

act entity tenant-private since 2026-10-01

Deletes a saved view: the caller's own, or one shared org-write. It is no longer listed. A view shared org-read by another member, or a system view, is refused (view_read_only). Repeating the same call answers the first deletion, replayed.

Contract

shape
entity
authority
act
evidence
none
subscription
false
permission
any one of: org.member (carried by the caller's role template in the org `org_id`); a deactivated caller is refused first
idempotency
natural
emits
none
MCP tool
delete_view
decision_set
approve, reject
REST
POST https://api.containertradehq.com/v1/cap/delete_view

Through MCP this call returns an approval request first; see Approvals.

Idempotency: keyed by the contract's own inputs: the same inputs replay the first call's result

Inputs

nametyperequiredvalidation
org_idorg_idrequiredtradehq-org-id; 1 to 20 characters
The org the view is in.
view_idtextrequired1 to 64 characters
The view to delete.

Response

  • view_id · string · The view deleted.
  • org_id · string · The org it was in.
  • title · string · What it was called.
  • deleted_by · string · Who deleted it.
Full JSON Schema 
{
  "type": "object",
  "properties": {
    "view_id": {
      "type": "string",
      "description": "The view deleted.",
      "x-data-class": "operational"
    },
    "org_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9_-]{1,20}$",
      "format": "tradehq-org-id",
      "description": "The org it was in.",
      "x-data-class": "operational"
    },
    "title": {
      "type": "string",
      "description": "What it was called.",
      "x-data-class": "operational"
    },
    "deleted_by": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[A-Za-z0-9_-]{1,20}$",
      "format": "tradehq-user-id",
      "description": "Who deleted it.",
      "x-data-class": "operational"
    }
  },
  "required": [
    "view_id",
    "org_id",
    "title",
    "deleted_by"
  ],
  "additionalProperties": false
}

Refusals

  • unknown_view · 422 · the org has no view by that id that the caller may read
  • view_read_only · 422 · a system view, or a view the caller may read and not change: another member's, shared org-read

The platform refusals apply to every call: version, authentication, authority, validation and rate limits, each in the same envelope.

Surfaces

DesktopF
MobileF
APIF
MCPF*
VoiceD2
PushN
OneBoxN
OutboundN
  • MCP: approval required
  • Voice: degraded: confirmation
  • Push: emits nothing
  • OneBox: no document originates a saved view
  • Outbound: crosses to no counterparty

Events

None emitted.

Related

get_view, get_view_default, pin_view, save_view, set_my_view_default, set_org_view_default, share_view