# Gofile

> Share files with Gofile, the free file host: upload a file and get a link anyone can open, keep files together in folders, and protect a folder with a password or have it expire on a date. Works without a Gofile account, or with your own.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/gofile

## Actions

### Create a folder

Make a Gofile folder to collect files in and share with one link, with an optional password, description, tags and expiry date.

**Inputs**

- Folder name (`name`, text): What to call the folder. Leave empty for a random name.
- Who can open it (`sharing`, text): Whether anyone with the folder's link can open it, or only this Gofile account. One of: `public` (Anyone with the link), `private` (Only this account). Default: `public`.
- Password (`password`, text): Visitors must type this before they can open the folder: 4 to 100 letters, numbers and symbols, with no spaces.
- Expires at (`expires_at`, date and time): When the folder stops being available. On a free Gofile account the folder and everything in it are then deleted for good; on Premium only its link stops working.
- Description (`description`, text): Text shown on the folder's page to everyone who opens it, up to 2,000 characters. Formatting such as **bold** works.
- Tags (`tags`, text): Labels to sort it by, separated by commas, such as invoices, 2026. Each is up to 25 letters, numbers, dashes and underscores. They replace any tags it had.
- Inside folder (`parent_folder`, text): The folder to create it in: its folder ID. Leave empty to create it at the top of the account.

**Outputs**

- `created_at` (text): When it was created, e.g. 2026-10-16T02:47:55Z.
- `description` (text): The folder's description. Null when it has none.
- `expires_at` (text): When the folder expires, e.g. 2026-10-17T02:47:54Z. Null when it doesn't.
- `folder_id` (text): The folder's ID, for Upload a file, Update a folder and Delete files or folders to use this folder.
- `is_public` (true/false): Whether anyone with the link can open it.
- `name` (text): The folder's name.
- `parent_folder_id` (text): The ID of the folder it was created in.
- `password_protected` (true/false): Whether visitors need the password.
- `share_url` (text): The folder's page, e.g. https://gofile.io/d/OTOOvwKY. It opens for anyone while the folder is shared with anyone with the link.
- `tags` (list): The folder's tags.

**Example output**

```json
{
  "created_at": "2026-10-16T02:47:55Z",
  "description": "Made by Lodol's **QA** workflow. Safe to delete.",
  "expires_at": "2026-10-17T02:47:54Z",
  "folder_id": "1b746a03-a18e-46e2-ae85-489ec1188fd5",
  "is_public": true,
  "name": "Lodol QA 0afe63",
  "parent_folder_id": "488ccd83-3021-47ed-ae3d-0c686cbf970f",
  "password_protected": true,
  "share_url": "https://gofile.io/d/OTOOvwKY",
  "tags": [
    "lodol",
    "qa"
  ]
}
```

### Delete files or folders

Delete files and folders from Gofile, a folder with everything in it. Unless the account's recycle bin is turned on, this can't be undone.

**Inputs**

- Files or folders (`items`, text, required): The ID of the file or folder to delete, from Upload a file or Create a folder. To delete several at once, separate their IDs with commas.

**Outputs**

- `already_gone` (list): IDs Gofile had nothing for: already deleted, or expired.
- `deleted` (list): The IDs of the files and folders deleted.
- `deleted_count` (number): How many files and folders were deleted.

**Example output**

```json
{
  "already_gone": [],
  "deleted": [
    "1b746a03-a18e-46e2-ae85-489ec1188fd5",
    "e43ca2e8-dfaa-41af-89b9-0fb7e3952e64"
  ],
  "deleted_count": 2
}
```

### Get account details

See the connected Gofile account: its type, its main folder, and how many files and folders it holds and how much space they use.

**Inputs**: None.

**Outputs**

- `account_type` (text): 'guest', 'standard' or 'premium'.
- `account_type_label` (text): The account type in words: Guest account, Standard account or Premium account.
- `created_at` (text): When the account was created, e.g. 2026-10-16T02:07:02Z.
- `email` (text): The account's email address. Null for a guest account.
- `file_count` (number): How many files the account holds.
- `folder_count` (number): How many folders the account holds.
- `is_guest` (true/false): Whether it is a guest account, which nobody signs in to: its files are opened through their links.
- `name` (text): The account's email address, or Guest and a number for a guest account.
- `root_folder_id` (text): The ID of the account's main folder, which holds everything else. Only the account can open it.
- `storage_used` (text): The space the files take, e.g. 2.5 MB.
- `storage_used_bytes` (number): The space the files take, in bytes.

**Example output**

```json
{
  "account_type": "guest",
  "account_type_label": "Guest account",
  "created_at": "2026-10-16T02:07:02Z",
  "email": null,
  "file_count": 3,
  "folder_count": 3,
  "is_guest": true,
  "name": "Guest 4836441203",
  "root_folder_id": "488ccd83-3021-47ed-ae3d-0c686cbf970f",
  "storage_used": "156 B",
  "storage_used_bytes": 156
}
```

### Update a file

Rename a file on Gofile or change its tags. Its link stays the same.

**Inputs**

- File (`file`, text, required): The file to change: its file ID, which Upload a file returns.
- New name (`name`, text): A new name for the file, extension included.
- Tags (`tags`, text): Labels to sort it by, separated by commas, such as invoices, 2026. Each is up to 25 letters, numbers, dashes and underscores. They replace any tags it had.
- Remove all tags (`remove_tags`, true/false): Take every tag off the file. Default: `false`.

**Outputs**

- `changes` (list): What this step changed, in order, as short phrases such as 'password set' or 'tags removed'.
- `content_type` (text): The kind of file, e.g. application/pdf or image/png.
- `file_id` (text): The file's ID, which Update a file and Delete files or folders take.
- `folder_id` (text): The ID of the folder the file is in.
- `name` (text): The file's name after the changes.
- `share_url` (text): The file's page, where it can be viewed and downloaded. It opens for anyone while the file's folder is shared with anyone with the link.
- `size` (text): The file's size as a person reads it, e.g. 13.3 KB.
- `size_bytes` (number): The file's size in bytes, e.g. 13264.
- `tags` (list): The file's tags after the changes. Null when this step left them as they were.

**Example output**

```json
{
  "changes": [
    "renamed to lodol-qa-0afe63-final.pdf",
    "tags set to lodol-qa"
  ],
  "content_type": "application/pdf",
  "file_id": "d364ecf3-2b43-487f-a954-47d75aad9ca5",
  "folder_id": "1b746a03-a18e-46e2-ae85-489ec1188fd5",
  "name": "lodol-qa-0afe63-final.pdf",
  "share_url": "https://gofile.io/d/d364ecf3-2b43-487f-a954-47d75aad9ca5",
  "size": "13.3 KB",
  "size_bytes": 13264,
  "tags": [
    "lodol-qa"
  ]
}
```

### Update a folder

Change a Gofile folder's name, who can open it, its password, expiry date, description or tags, or remove any of them. Settings left empty stay as they are.

**Inputs**

- Folder (`folder`, text, required): The folder to change: its folder ID, which Create a folder and Upload a file return.
- New name (`name`, text): A new name for the folder.
- Who can open it (`sharing`, text): Open the folder to anyone with its link, make it private to this Gofile account, or leave it as it is. One of: `unchanged` (Leave as it is), `public` (Anyone with the link), `private` (Only this account). Default: `unchanged`.
- Password (`password`, text): Visitors must type this before they can open the folder: 4 to 100 letters, numbers and symbols, with no spaces.
- Expires at (`expires_at`, date and time): When the folder stops being available. On a free Gofile account the folder and everything in it are then deleted for good; on Premium only its link stops working.
- Description (`description`, text): Text shown on the folder's page to everyone who opens it, up to 2,000 characters. Formatting such as **bold** works.
- Tags (`tags`, text): Labels to sort it by, separated by commas, such as invoices, 2026. Each is up to 25 letters, numbers, dashes and underscores. They replace any tags it had.
- Remove (`remove`, list): Settings to take off the folder. One or more of: `description`, `tags`, `password`, `expiry` (Expiry date).

**Outputs**

- `changes` (list): What this step changed, in order, as short phrases such as 'password set' or 'tags removed'.
- `expires_at` (text): The new expiry time, e.g. 2026-10-18T02:47:54Z. Null when this step didn't set one.
- `folder_id` (text): The folder's ID, for Upload a file, Update a folder and Delete files or folders to use this folder.
- `is_public` (true/false): Whether anyone with the link can now open it. Null when this step left it as it was.
- `name` (text): The folder's name after the changes.
- `password_protected` (true/false): Whether visitors now need a password. Null when this step left it as it was.
- `share_url` (text): The folder's page, e.g. https://gofile.io/d/OTOOvwKY. It opens for anyone while the folder is shared with anyone with the link.

**Example output**

```json
{
  "changes": [
    "renamed to Lodol QA 0afe63 (private)",
    "description removed",
    "tags removed",
    "password removed",
    "expires 2026-10-18T02:47:54Z",
    "only this account can open it"
  ],
  "expires_at": "2026-10-18T02:47:54Z",
  "folder_id": "1b746a03-a18e-46e2-ae85-489ec1188fd5",
  "is_public": false,
  "name": "Lodol QA 0afe63 (private)",
  "password_protected": false,
  "share_url": "https://gofile.io/d/1b746a03-a18e-46e2-ae85-489ec1188fd5"
}
```

### Upload a file

Put a file on Gofile and get a link anyone can open to view and download it. The file goes into a new folder of its own unless you choose one.

**Inputs**

- File (`file`, text, required): The file to upload: upload one, pick one from an earlier step, or paste a public link to one (up to 100 MB from a link).
- File name (`name`, text): What to call the file on Gofile. Leave empty to keep its own name; if you leave off the extension, the file's own is added.
- Folder (`folder`, text): The folder to put the file in: its folder ID, from Create a folder or an earlier upload. Leave empty to put the file in a new folder that anyone with the link can open.

**Outputs**

- `content_type` (text): The kind of file, e.g. application/pdf or image/png.
- `file_id` (text): The file's ID, which Update a file and Delete files or folders take.
- `folder_id` (text): The ID of the folder the file is in. Give it to the next Upload a file to add more files to the same folder, or to Update a folder to protect it.
- `folder_share_url` (text): The page of the folder the file is in, listing everything in it, e.g. https://gofile.io/d/s5FWR7xy.
- `name` (text): The file's name.
- `share_url` (text): The file's page, where it can be viewed and downloaded, e.g. https://gofile.io/d/BOT1eEeE. It opens for anyone while the file's folder is shared with anyone with the link, as a new folder is.
- `size` (text): The file's size as a person reads it, e.g. 13.3 KB.
- `size_bytes` (number): The file's size in bytes, e.g. 13264.
- `uploaded_at` (text): When it was uploaded, e.g. 2026-10-16T02:47:59Z.

**Example output**

```json
{
  "content_type": "application/pdf",
  "file_id": "c95f4eda-70d1-4e34-8617-ee5b8c5391d6",
  "folder_id": "e43ca2e8-dfaa-41af-89b9-0fb7e3952e64",
  "folder_share_url": "https://gofile.io/d/s5FWR7xy",
  "name": "dummy.pdf",
  "share_url": "https://gofile.io/d/BOT1eEeE",
  "size": "13.3 KB",
  "size_bytes": 13264,
  "uploaded_at": "2026-10-16T02:47:59Z"
}
```