# ownCloud

> Keep your ownCloud files in order: upload, download, find, move, copy and delete files and folders, and share them by link or with people and groups. Start a workflow when a file is added or changed, or something is shared with you.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/owncloud

## Actions

### Copy file or folder

Copy a file or folder to another folder, under a new name, or both.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.
- To folder (`destination_folder`, text): The folder to copy it into, such as /Archive/2026. It's made if it isn't there yet. Leave blank to keep it in the same folder.
- New name (`new_name`, text): A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
- Replace (`replace`, true/false): Write over anything already there with that name. Off: the step stops and says so. Default: `false`.

**Outputs**

- `checksum` (text): The file's SHA-1 checksum, which changes with its content; empty for a folder
- `content_type` (text): Its type, such as application/pdf; empty for a folder
- `etag` (text): A tag that changes whenever it does
- `file_id` (text): ownCloud's ID for it, which stays the same when it's moved
- `link` (text): A link that opens it in ownCloud, for people who can see it
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `name` (text): Its name, such as invoice-1001.pdf
- `owner` (text): The name of the person it belongs to
- `path` (text): Its path, such as /Invoices/invoice-1001.pdf
- `shared` (true/false): True when it's shared with people or by a link
- `size` (number): Its size in bytes; for a folder, everything in it
- `type` (text): file or folder

**Example output**

```json
{
  "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
  "content_type": "application/pdf",
  "etag": "6720f1c3a8b2e9d1",
  "file_id": "4182",
  "link": "https://cloud.example.com/f/4182",
  "modified_at": "2026-11-05T09:30:00Z",
  "name": "invoice-1001.pdf",
  "owner": "Alex Rivera",
  "path": "/Archive/2026/invoice-1001.pdf",
  "shared": false,
  "size": 48213,
  "type": "file"
}
```

### Create folder

Make a folder, and any folders above it that aren't there yet. Nothing changes if it's already there.

**Inputs**

- Path (`path`, text, required): The folder, such as /Clients/Acme/2026.

**Outputs**

- `checksum` (text): The file's SHA-1 checksum, which changes with its content; empty for a folder
- `content_type` (text): Its type, such as application/pdf; empty for a folder
- `created` (true/false): False when the folder was already there
- `etag` (text): A tag that changes whenever it does
- `file_id` (text): ownCloud's ID for it, which stays the same when it's moved
- `link` (text): A link that opens it in ownCloud, for people who can see it
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `name` (text): Its name, such as invoice-1001.pdf
- `owner` (text): The name of the person it belongs to
- `path` (text): Its path, such as /Invoices/invoice-1001.pdf
- `shared` (true/false): True when it's shared with people or by a link
- `size` (number): Its size in bytes; for a folder, everything in it
- `type` (text): file or folder

**Example output**

```json
{
  "checksum": "",
  "content_type": "",
  "created": true,
  "etag": "6720f1c3a8b2f",
  "file_id": "4180",
  "link": "https://cloud.example.com/f/4180",
  "modified_at": "2026-11-05T09:30:00Z",
  "name": "2026",
  "owner": "Alex Rivera",
  "path": "/Invoices/2026",
  "shared": false,
  "size": 0,
  "type": "folder"
}
```

### Create share link

Make a link anyone can open a file or folder with, to send to someone, with a password and end date if you like.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.
- Access (`access`, text): What people with the link can do. Edit and Upload only are for folders; Upload only lets people drop files in without seeing what's there. One of: `view` (View and download), `edit` (Edit (folders)), `upload` (Upload only (folders)). Default: `view`.
- Password (`password`, text): A password the link asks for. Leave blank for none, unless your server requires one.
- Expires (`expires_on`, date): The day the link stops working. Leave blank to keep it working, unless your server sets a limit.
- Link name (`link_name`, text): A name for the link, shown in ownCloud's sharing panel, such as For the auditors.

**Outputs**

- `access` (text): view, edit, or for a folder link, upload (file drop)
- `can_reshare` (true/false): Whether they may share it on
- `created_at` (text): When it was shared (ISO 8601, UTC)
- `expires_on` (text): The day it stops working (YYYY-MM-DD); empty if never
- `has_password` (true/false): Whether the link asks for a password
- `id` (text): The share's ID, for 'Delete share'
- `item_type` (text): file or folder
- `link_name` (text): The link's name, shown in ownCloud's sharing panel
- `name` (text): The shared file or folder's name
- `owner` (text): The username of who shared it
- `owner_name` (text): Their full name
- `path` (text): What it shares, as the person it's shared with sees it
- `share_type` (text): link, user or group
- `shared_with` (text): The username or group it's shared with; empty for a link
- `shared_with_name` (text): Their full name, or the group's
- `state` (text): For a share made with you: accepted, pending or declined; otherwise empty
- `url` (text): The link to send; empty for a share with people

**Example output**

```json
{
  "access": "view",
  "can_reshare": false,
  "created_at": "2026-11-05T09:31:00Z",
  "expires_on": "2026-12-31",
  "has_password": true,
  "id": "37",
  "item_type": "file",
  "link_name": "For the auditors",
  "name": "invoice-1001.pdf",
  "owner": "alex",
  "owner_name": "Alex Rivera",
  "path": "/Invoices/invoice-1001.pdf",
  "share_type": "link",
  "shared_with": "",
  "shared_with_name": "",
  "state": "",
  "url": "https://cloud.example.com/s/Hx7KQp2LmNtR4sB"
}
```

### Delete file or folder

Delete a file or folder. It goes to ownCloud's trash, where it can be restored.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.

**Outputs**

- `deleted` (true/false): True once deleted
- `path` (text): What was deleted
- `type` (text): file or folder

**Example output**

```json
{
  "deleted": true,
  "path": "/Inbox/old-scan.pdf",
  "type": "file"
}
```

### Delete share

Stop a share you made: a link stops working, or people lose access.

**Inputs**

- Share ID (`share`, text, required): The share's ID, a number, from 'Create share link', 'Share with person' or 'List shares'.

**Outputs**

- `deleted` (true/false): True once the share has stopped
- `id` (text): The share's ID

**Example output**

```json
{
  "deleted": true,
  "id": "37"
}
```

### Download file

Download a file for later steps, such as attaching it to an email. A text file of 1 MB or less is also given as text.

**Inputs**

- Path (`path`, text, required): The file, such as /Invoices/invoice-1001.pdf.

**Outputs**

- `content_type` (text): Its type, such as application/pdf
- `document_ref` (text): The downloaded file, for a later step's file field
- `file_name` (text): The file's name
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `path` (text): The file's path
- `size` (number): Its size in bytes
- `text` (text): What it says, for a text file of 1 MB or less; otherwise empty

**Example output**

```json
{
  "content_type": "text/csv",
  "document_ref": "doc_0123456789abcdef0123456789abcdef",
  "file_name": "q1-summary.csv",
  "modified_at": "2026-11-05T09:30:00Z",
  "path": "/Reports/2026/q1-summary.csv",
  "size": 38,
  "text": "month,revenue\nJan,100\nFeb,120\nMar,140\n"
}
```

### Find people to share with

Find people and groups on your ownCloud by name, username or email, to share with.

**Inputs**

- Name or email (`query`, text, required): Part of their name, username or email, such as sam or @example.com.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 200.

**Outputs**

- `count` (number): How many
- `query` (text): What was searched for
- `results` (list): The people and groups found, exact matches first

**Example output**

```json
{
  "count": 1,
  "query": "sam",
  "results": [
    {
      "exact": true,
      "id": "sam",
      "name": "Sam Okafor",
      "type": "user"
    }
  ]
}
```

### Get account

Who the connection signs in as, the groups they're in, and how much space is used and left.

**Inputs**: None.

**Outputs**

- `email` (text): Its email address
- `free_bytes` (number): Space left, in bytes
- `groups` (list): The groups it's in
- `name` (text): Its full name
- `quota` (text): Its space limit, such as 5 GB; empty when it has none of its own
- `used_bytes` (number): Space used, in bytes
- `user_id` (text): The account's username

**Example output**

```json
{
  "email": "alex@example.com",
  "free_bytes": 3436238029,
  "groups": [
    "Finance",
    "Records"
  ],
  "name": "Alex Rivera",
  "quota": "5 GB",
  "used_bytes": 1932735283,
  "user_id": "alex"
}
```

### Get file details

Look up a file or folder: its size, type, when it last changed, who it belongs to, and its link.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.

**Outputs**

- `checksum` (text): The file's SHA-1 checksum, which changes with its content; empty for a folder
- `content_type` (text): Its type, such as application/pdf; empty for a folder
- `etag` (text): A tag that changes whenever it does
- `file_id` (text): ownCloud's ID for it, which stays the same when it's moved
- `link` (text): A link that opens it in ownCloud, for people who can see it
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `name` (text): Its name, such as invoice-1001.pdf
- `owner` (text): The name of the person it belongs to
- `path` (text): Its path, such as /Invoices/invoice-1001.pdf
- `shared` (true/false): True when it's shared with people or by a link
- `size` (number): Its size in bytes; for a folder, everything in it
- `type` (text): file or folder

**Example output**

```json
{
  "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
  "content_type": "application/pdf",
  "etag": "6720f1c3a8b2e9d1",
  "file_id": "4182",
  "link": "https://cloud.example.com/f/4182",
  "modified_at": "2026-11-05T09:30:00Z",
  "name": "invoice-1001.pdf",
  "owner": "Alex Rivera",
  "path": "/Invoices/invoice-1001.pdf",
  "shared": false,
  "size": 48213,
  "type": "file"
}
```

### List folder

List the files and folders in a folder, folders first, with their sizes and when they changed.

**Inputs**

- Folder (`folder`, text): The folder, such as /Invoices. Leave blank for your top folder.
- Include subfolders (`include_subfolders`, true/false): Also list everything in the folders inside it, all the way down (up to 200 folders). Default: `false`.
- How many (`limit`, number): The most to list. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `folder` (text): The folder listed
- `items` (list): The files and folders, folders first
- `more` (true/false): True when there were more than were listed

**Example output**

```json
{
  "count": 2,
  "folder": "/Invoices",
  "items": [
    {
      "checksum": "",
      "content_type": "",
      "etag": "6720f1c3a8b2f",
      "file_id": "4180",
      "link": "https://cloud.example.com/f/4180",
      "modified_at": "2026-11-05T09:30:00Z",
      "name": "2026",
      "owner": "Alex Rivera",
      "path": "/Invoices/2026",
      "shared": false,
      "size": 0,
      "type": "folder"
    },
    {
      "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
      "content_type": "application/pdf",
      "etag": "6720f1c3a8b2e9d1",
      "file_id": "4182",
      "link": "https://cloud.example.com/f/4182",
      "modified_at": "2026-11-05T09:30:00Z",
      "name": "invoice-1001.pdf",
      "owner": "Alex Rivera",
      "path": "/Invoices/invoice-1001.pdf",
      "shared": false,
      "size": 48213,
      "type": "file"
    }
  ],
  "more": false
}
```

### List shares

List the links and shares you made, of one file or folder or all of them, or what others have shared with you.

**Inputs**

- Path (`path`, text): Only shares of this file or folder, such as /Invoices. Leave blank for all.
- Shared with me (`shared_with_me`, true/false): List what others have shared with you, not what you shared. Default: `false`.

**Outputs**

- `count` (number): How many
- `shares` (list): The shares, by path

**Example output**

```json
{
  "count": 2,
  "shares": [
    {
      "access": "view",
      "can_reshare": false,
      "created_at": "2026-11-05T09:31:00Z",
      "expires_on": "2026-12-31",
      "has_password": true,
      "id": "37",
      "item_type": "file",
      "link_name": "For the auditors",
      "name": "invoice-1001.pdf",
      "owner": "alex",
      "owner_name": "Alex Rivera",
      "path": "/Invoices/invoice-1001.pdf",
      "share_type": "link",
      "shared_with": "",
      "shared_with_name": "",
      "state": "",
      "url": "https://cloud.example.com/s/Hx7KQp2LmNtR4sB"
    },
    {
      "access": "edit",
      "can_reshare": false,
      "created_at": "2026-11-05T09:31:00Z",
      "expires_on": "",
      "has_password": false,
      "id": "38",
      "item_type": "file",
      "link_name": "",
      "name": "invoice-1001.pdf",
      "owner": "alex",
      "owner_name": "Alex Rivera",
      "path": "/Invoices/invoice-1001.pdf",
      "share_type": "user",
      "shared_with": "sam",
      "shared_with_name": "Sam Okafor",
      "state": "",
      "url": ""
    }
  ]
}
```

### Move or rename

Move a file or folder to another folder, give it a new name, or both.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.
- To folder (`destination_folder`, text): The folder to move it into, such as /Archive/2026. It's made if it isn't there yet. Leave blank to keep it in the same folder.
- New name (`new_name`, text): A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
- Replace (`replace`, true/false): Write over anything already there with that name. Off: the step stops and says so. Default: `false`.

**Outputs**

- `checksum` (text): The file's SHA-1 checksum, which changes with its content; empty for a folder
- `content_type` (text): Its type, such as application/pdf; empty for a folder
- `etag` (text): A tag that changes whenever it does
- `file_id` (text): ownCloud's ID for it, which stays the same when it's moved
- `link` (text): A link that opens it in ownCloud, for people who can see it
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `name` (text): Its name, such as invoice-1001.pdf
- `owner` (text): The name of the person it belongs to
- `path` (text): Its path, such as /Invoices/invoice-1001.pdf
- `shared` (true/false): True when it's shared with people or by a link
- `size` (number): Its size in bytes; for a folder, everything in it
- `type` (text): file or folder

**Example output**

```json
{
  "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
  "content_type": "application/pdf",
  "etag": "6720f1c3a8b2e9d1",
  "file_id": "4182",
  "link": "https://cloud.example.com/f/4182",
  "modified_at": "2026-11-05T09:30:00Z",
  "name": "invoice-1001.pdf",
  "owner": "Alex Rivera",
  "path": "/Archive/2026/invoice-1001.pdf",
  "shared": false,
  "size": 48213,
  "type": "file"
}
```

### Search files

Find files and folders whose name contains some words, most recently changed first.

**Inputs**

- Name contains (`query`, text, required): Part of the name, such as invoice.
- Folder (`folder`, text): Only look in this folder and the folders inside it. Leave blank to look everywhere.
- How many (`limit`, number): The most to list. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many
- `folder` (text): The folder searched in; / for everywhere
- `items` (list): The files and folders found, most recently changed first
- `query` (text): What was searched for

**Example output**

```json
{
  "count": 1,
  "folder": "/",
  "items": [
    {
      "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
      "content_type": "application/pdf",
      "etag": "6720f1c3a8b2e9d1",
      "file_id": "4182",
      "link": "https://cloud.example.com/f/4182",
      "modified_at": "2026-11-05T09:30:00Z",
      "name": "invoice-1001.pdf",
      "owner": "Alex Rivera",
      "path": "/Invoices/invoice-1001.pdf",
      "shared": false,
      "size": 48213,
      "type": "file"
    }
  ],
  "query": "invoice"
}
```

### Share with group

Share a file or folder with everyone in an ownCloud group. It shows up in their files.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.
- Group (`group`, text, required): The group: pick one of yours, or type its name.
- Access (`access`, text): What they can do with it. Edit lets them change it, and for a folder add and delete files in it. One of: `view` (View and download), `edit`. Default: `view`.
- Expires (`expires_on`, date): The day the group's access ends. Leave blank to keep it shared.

**Outputs**

- `access` (text): view, edit, or for a folder link, upload (file drop)
- `can_reshare` (true/false): Whether they may share it on
- `created_at` (text): When it was shared (ISO 8601, UTC)
- `expires_on` (text): The day it stops working (YYYY-MM-DD); empty if never
- `has_password` (true/false): Whether the link asks for a password
- `id` (text): The share's ID, for 'Delete share'
- `item_type` (text): file or folder
- `link_name` (text): The link's name, shown in ownCloud's sharing panel
- `name` (text): The shared file or folder's name
- `owner` (text): The username of who shared it
- `owner_name` (text): Their full name
- `path` (text): What it shares, as the person it's shared with sees it
- `share_type` (text): link, user or group
- `shared_with` (text): The username or group it's shared with; empty for a link
- `shared_with_name` (text): Their full name, or the group's
- `state` (text): For a share made with you: accepted, pending or declined; otherwise empty
- `url` (text): The link to send; empty for a share with people

**Example output**

```json
{
  "access": "view",
  "can_reshare": false,
  "created_at": "2026-11-05T09:31:00Z",
  "expires_on": "",
  "has_password": false,
  "id": "39",
  "item_type": "folder",
  "link_name": "",
  "name": "Invoices",
  "owner": "alex",
  "owner_name": "Alex Rivera",
  "path": "/Invoices",
  "share_type": "group",
  "shared_with": "Finance",
  "shared_with_name": "Finance",
  "state": "",
  "url": ""
}
```

### Share with person

Share a file or folder with someone who has an account on the same ownCloud. It shows up in their files.

**Inputs**

- Path (`path`, text, required): The file or folder, such as /Invoices/invoice-1001.pdf.
- Person (`user`, text, required): Their username, email or full name, such as sam@example.com.
- Access (`access`, text): What they can do with it. Edit lets them change it, and for a folder add and delete files in it. One of: `view` (View and download), `edit`. Default: `view`.
- Expires (`expires_on`, date): The day their access ends. Leave blank to keep it shared.

**Outputs**

- `access` (text): view, edit, or for a folder link, upload (file drop)
- `can_reshare` (true/false): Whether they may share it on
- `created_at` (text): When it was shared (ISO 8601, UTC)
- `expires_on` (text): The day it stops working (YYYY-MM-DD); empty if never
- `has_password` (true/false): Whether the link asks for a password
- `id` (text): The share's ID, for 'Delete share'
- `item_type` (text): file or folder
- `link_name` (text): The link's name, shown in ownCloud's sharing panel
- `name` (text): The shared file or folder's name
- `owner` (text): The username of who shared it
- `owner_name` (text): Their full name
- `path` (text): What it shares, as the person it's shared with sees it
- `share_type` (text): link, user or group
- `shared_with` (text): The username or group it's shared with; empty for a link
- `shared_with_name` (text): Their full name, or the group's
- `state` (text): For a share made with you: accepted, pending or declined; otherwise empty
- `url` (text): The link to send; empty for a share with people

**Example output**

```json
{
  "access": "edit",
  "can_reshare": false,
  "created_at": "2026-11-05T09:31:00Z",
  "expires_on": "",
  "has_password": false,
  "id": "38",
  "item_type": "file",
  "link_name": "",
  "name": "invoice-1001.pdf",
  "owner": "alex",
  "owner_name": "Alex Rivera",
  "path": "/Invoices/invoice-1001.pdf",
  "share_type": "user",
  "shared_with": "sam",
  "shared_with_name": "Sam Okafor",
  "state": "",
  "url": ""
}
```

### Upload file

Put a file in a folder, such as an email attachment or a PDF made in an earlier step, or save text as a file.

**Inputs**

- Folder (`folder`, text): The folder to put it in, such as /Invoices/2026. It's made if it isn't there yet. Leave blank for your top folder.
- File (`file`, text): The file: upload one, pick a file from an earlier step, or paste a link to one. Use this or Text.
- Text (`text`, text): Words to save as the file, such as a CSV or notes. Use this or File, and give a file name.
- File name (`file_name`, text): What to call it, such as invoice-1001.pdf. Leave blank to keep the file's own name.
- Replace (`replace`, true/false): Write over a file with the same name. Off: ownCloud keeps both, adding (2) to the new one's name. Default: `false`.

**Outputs**

- `checksum` (text): The file's SHA-1 checksum, which changes with its content; empty for a folder
- `content_type` (text): Its type, such as application/pdf; empty for a folder
- `etag` (text): A tag that changes whenever it does
- `file_id` (text): ownCloud's ID for it, which stays the same when it's moved
- `link` (text): A link that opens it in ownCloud, for people who can see it
- `modified_at` (text): When it last changed (ISO 8601, UTC)
- `name` (text): Its name, such as invoice-1001.pdf
- `owner` (text): The name of the person it belongs to
- `path` (text): Its path, such as /Invoices/invoice-1001.pdf
- `shared` (true/false): True when it's shared with people or by a link
- `size` (number): Its size in bytes; for a folder, everything in it
- `type` (text): file or folder

**Example output**

```json
{
  "checksum": "1764f997e08ac89287e4c38848f4916e4b98c219",
  "content_type": "application/pdf",
  "etag": "6720f1c3a8b2e9d1",
  "file_id": "4182",
  "link": "https://cloud.example.com/f/4182",
  "modified_at": "2026-11-05T09:30:00Z",
  "name": "invoice-1001.pdf",
  "owner": "Alex Rivera",
  "path": "/Invoices/invoice-1001.pdf",
  "shared": false,
  "size": 48213,
  "type": "file"
}
```
