Zum Inhalt
Für Agenten

MCP Reference

drive_link_save

Create or Update Share Link

Markdown Tools als JSON

Beschreibung

Linear-style upsert. Omit id to mint a fresh share link for the given file. Pass id (dlk_…) to update expiry or password on an existing link. Same primitives as the in-app share modal:

  • expires_at — ISO 8601, date-only, or relative offset (+7d, +2h). Null / omitted = no expiry.
  • password — plaintext; hashed via has_secure_password AND stored plaintext-encrypted so a manager can look it up later. Null / omitted on create = no password. On update, omit to keep existing; pass empty string to clear.

Manager on the drive is required (Pundit DriveLinkPolicy). Returns the public /links/:token URL.

Zugriff

Zugriffsprofil: gated. Module: files. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja
id string Nein DriveLink prefix ID (dlk_…). Omit to create.
file_id string Nein File prefix ID (dfi_…). Required on create.
expires_at string / null Nein ISO 8601, date, or relative offset (+7d).
password string / null Nein Plaintext password. Empty string clears on update.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "description": "DriveLink prefix ID (dlk_…). Omit to create."
    },
    "file_id": {
      "type": "string",
      "description": "File prefix ID (dfi_…). Required on create."
    },
    "expires_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 8601, date, or relative offset (`+7d`)."
    },
    "password": {
      "type": [
        "string",
        "null"
      ],
      "description": "Plaintext password. Empty string clears on update."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string"
    },
    "file_id": {
      "type": "string"
    },
    "token": {
      "type": "string"
    },
    "public_url": {
      "type": "string"
    },
    "expires_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "password_protected": {
      "type": "boolean"
    },
    "revoked": {
      "type": "boolean"
    },
    "created": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "file_id",
    "token",
    "public_url",
    "expires_at",
    "password_protected",
    "revoked",
    "created"
  ],
  "type": "object"
}
Seiten