action files_file_action_find {
  label: "Find file/folder by path"
  description: "Find file/folder by path"
  provider: files
  method: GET
  path: "/file_actions/metadata/{path}"
  encoding: json
  input: {
    type: "object"
    properties: {
      path: {
        type: "string"
      }
      preview_size: {
        type: "string"
      }
      with_previews: {
        type: "boolean"
      }
      with_priority_color: {
        type: "boolean"
      }
    }
    required: ["path"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "List Folders by path"
    properties: {
      crc32: {
        type: "string"
        description: "File CRC32 checksum. This is sometimes delayed, so if you get a blank response, wait and try again."
      }
      created_at: {
        type: "string"
        format: "date-time"
        description: "File created date/time"
      }
      display_name: {
        type: "string"
        description: "File/Folder display name"
      }
      download_uri: {
        type: "string"
        description: "Link to download file. Provided only in response to a download request."
      }
      is_locked: {
        type: "boolean"
        description: "Is this folder locked and unable to be modified?"
      }
      md5: {
        type: "string"
        description: "File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again."
      }
      mime_type: {
        type: "string"
        description: "MIME Type.  This is determined by the filename extension and is not stored separately internally."
      }
      mtime: {
        type: "string"
        format: "date-time"
        description: "File last modified date/time, according to the server.  This is the timestamp of the last Files.com operation of the file, regardless of what modified timestamp was sent."
      }
      path: {
        type: "string"
        description: "File/Folder path"
      }
      permissions: {
        type: "string"
        description: "A short string representing the current user's permissions.  Can be `r`,`w`,`d`, `l` or any combination"
      }
      preview: {
        type: "object"
        properties: {
          download_uri: {
            type: "string"
            description: "Link to download preview"
          }
          id: {
            type: "integer"
            format: "int32"
            description: "Preview ID"
          }
          size: {
            type: "string"
            description: "Preview size"
          }
          status: {
            type: "string"
            description: "Preview status.  Can be invalid, not_generated, generating, complete, or file_too_large"
          }
          type: {
            type: "string"
            description: "Preview type. Can be image, pdf, pdf_native, video, or audio"
          }
        }
      }
      preview_id: {
        type: "integer"
        format: "int32"
        description: "File preview ID"
      }
      priority_color: {
        type: "string"
        description: "Bookmark/priority color of file/folder"
      }
      provided_mtime: {
        type: "string"
        format: "date-time"
        description: "File last modified date/time, according to the client who set it.  Files.com allows desktop, FTP, SFTP, and WebDAV clients to set modified at times.  This allows Desktop<->Cloud syncing to preserve modified at times."
      }
      region: {
        type: "string"
        description: "Region location"
      }
      size: {
        type: "integer"
        format: "int32"
        description: "File/Folder size"
      }
      "subfolders_locked?": {
        type: "boolean"
        description: "Are subfolders locked and unable to be modified?"
      }
      type: {
        type: "string"
        description: "Type: `directory` or `file`."
      }
    }
  }
}