read.internal.assets

The tenant’s asset library (id, kind, provider_key, metadata), filterable by kind, searchable by filename/key and sortable by file name or recency. Internal face only.

• Surface: GET /v1/read/internal/assets · MCP tool read.internal.assets
• Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires the content.read scope. The tenant is resolved from the CALLER’s identity, never from store. Personal fields come back MASKED for an actor without pii.read (the shape is unchanged).

Params (JSON Schema)

{
  "properties": {
    "kind": {
      "enum": [
        "image",
        "document",
        "video_external"
      ],
      "type": "string"
    },
    "q": {
      "minLength": 1,
      "type": "string"
    },
    "sort": {
      "enum": [
        "file_asc",
        "file_desc",
        "newest"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Result (200)

Open (unknown) — this capability does not declare an output schema.

Errors

validation_failed (400) · not_found (404) · unauthorized (401) · forbidden (403)