Skip to main content
FuseFuse
IntegrationsGoogle workspaceActions

List Google Drive permissions

List ACL fragments on a Drive file the connected principal can access. permission_details remains an unflattened array.

Agent markdown

drive.permissions.list · Google Workspace · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • https://www.googleapis.com/auth/drive.metadata.readonly

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
file_idstringYesminLength 1; maxLength 256
page_sizeintegerNominimum 1; maximum 100
page_tokenstringNominLength 1; maxLength 512

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
permissionsarray<object>YesmaxItems 100
permissions[]objectYesadditionalProperties false
permissions[].idstringYesmaxLength 256
permissions[].rolestringYesmaxLength 64
permissions[].typestringYesmaxLength 64
permissions[].email_addressstringNomaxLength 320
permissions[].domainstringNomaxLength 256
permissions[].viewstringNomaxLength 64
permissions[].allow_file_discoverybooleanNo
permissions[].expires_atstringNomaxLength 64
permissions[].deletedbooleanNo
permissions[].pending_ownerbooleanNo
permissions[].inherited_permissions_disabledbooleanNo
permissions[].permission_detailsarray<object>YesmaxItems 20
permissions[].permission_details[]objectYesadditionalProperties false
permissions[].permission_details[].permission_typestringNomaxLength 64
permissions[].permission_details[].rolestringYesmaxLength 64
permissions[].permission_details[].inheritedbooleanYes
permissions[].permission_details[].inherited_from_idstringNomaxLength 256
next_page_tokenstringNomaxLength 512

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "file_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "page_token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    }
  },
  "required": [
    "file_id"
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "permissions": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 256
          },
          "role": {
            "type": "string",
            "maxLength": 64
          },
          "type": {
            "type": "string",
            "maxLength": 64
          },
          "email_address": {
            "type": "string",
            "maxLength": 320
          },
          "domain": {
            "type": "string",
            "maxLength": 256
          },
          "view": {
            "type": "string",
            "maxLength": 64
          },
          "allow_file_discovery": {
            "type": "boolean"
          },
          "expires_at": {
            "type": "string",
            "maxLength": 64
          },
          "deleted": {
            "type": "boolean"
          },
          "pending_owner": {
            "type": "boolean"
          },
          "inherited_permissions_disabled": {
            "type": "boolean"
          },
          "permission_details": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "permission_type": {
                  "type": "string",
                  "maxLength": 64
                },
                "role": {
                  "type": "string",
                  "maxLength": 64
                },
                "inherited": {
                  "type": "boolean"
                },
                "inherited_from_id": {
                  "type": "string",
                  "maxLength": 256
                }
              },
              "required": [
                "role",
                "inherited"
              ]
            },
            "maxItems": 20
          }
        },
        "required": [
          "id",
          "role",
          "type",
          "permission_details"
        ]
      },
      "maxItems": 100
    },
    "next_page_token": {
      "type": "string",
      "maxLength": 512
    }
  },
  "required": [
    "permissions"
  ]
}