ownCloud
App · 16 actions
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.
Actions
| Action | What it does |
|---|---|
| Copy file or folder | Copy a file or folder to another folder, under a new name, or both. |
| Create folder | Make a folder, and any folders above it that aren't there yet. |
| 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. |
| Delete file or folder | Delete a file or folder. |
| Delete share | Stop a share you made: a link stops working, or people lose access. |
| Download file | Download a file for later steps, such as attaching it to an email. |
| Find people to share with | Find people and groups on your ownCloud by name, username or email, to share with. |
| Get account | Who the connection signs in as, the groups they're in, and how much space is used and left. |
| Get file details | Look up a file or folder: its size, type, when it last changed, who it belongs to, and its link. |
| List folder | List the files and folders in a folder, folders first, with their sizes and when they changed. |
| 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. |
| Move or rename | Move a file or folder to another folder, give it a new name, or both. |
| Search files | Find files and folders whose name contains some words, most recently changed first. |
| Share with group | Share a file or folder with everyone in an ownCloud group. |
| Share with person | Share a file or folder with someone who has an account on the same ownCloud. |
| 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. |
Copy file or folder
Copy a file or folder to another folder, under a new name, or both.
Inputs
- Path
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
- To folder
destination_foldertext - 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_nametext - A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
- Replace
replacetrue/false - Write over anything already there with that name. Off: the step stops and says so.Default:
false.
Outputs
checksumtext- The file's SHA-1 checksum, which changes with its content; empty for a folder
content_typetext- Its type, such as application/pdf; empty for a folder
etagtext- A tag that changes whenever it does
file_idtext- ownCloud's ID for it, which stays the same when it's moved
linktext- A link that opens it in ownCloud, for people who can see it
modified_attext- When it last changed (ISO 8601, UTC)
nametext- Its name, such as invoice-1001.pdf
ownertext- The name of the person it belongs to
pathtext- Its path, such as /Invoices/invoice-1001.pdf
sharedtrue/false- True when it's shared with people or by a link
sizenumber- Its size in bytes; for a folder, everything in it
typetext- file or folder
Example output
{
"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
pathtextRequired - The folder, such as /Clients/Acme/2026.
Outputs
checksumtext- The file's SHA-1 checksum, which changes with its content; empty for a folder
content_typetext- Its type, such as application/pdf; empty for a folder
createdtrue/false- False when the folder was already there
etagtext- A tag that changes whenever it does
file_idtext- ownCloud's ID for it, which stays the same when it's moved
linktext- A link that opens it in ownCloud, for people who can see it
modified_attext- When it last changed (ISO 8601, UTC)
nametext- Its name, such as invoice-1001.pdf
ownertext- The name of the person it belongs to
pathtext- Its path, such as /Invoices/invoice-1001.pdf
sharedtrue/false- True when it's shared with people or by a link
sizenumber- Its size in bytes; for a folder, everything in it
typetext- file or folder
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
- Access
accesstext - 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
passwordtext - A password the link asks for. Leave blank for none, unless your server requires one.
- Expires
expires_ondate - The day the link stops working. Leave blank to keep it working, unless your server sets a limit.
- Link name
link_nametext - A name for the link, shown in ownCloud's sharing panel, such as For the auditors.
Outputs
accesstext- view, edit, or for a folder link, upload (file drop)
can_resharetrue/false- Whether they may share it on
created_attext- When it was shared (ISO 8601, UTC)
expires_ontext- The day it stops working (YYYY-MM-DD); empty if never
has_passwordtrue/false- Whether the link asks for a password
idtext- The share's ID, for 'Delete share'
item_typetext- file or folder
link_nametext- The link's name, shown in ownCloud's sharing panel
nametext- The shared file or folder's name
ownertext- The username of who shared it
owner_nametext- Their full name
pathtext- What it shares, as the person it's shared with sees it
share_typetext- link, user or group
shared_withtext- The username or group it's shared with; empty for a link
shared_with_nametext- Their full name, or the group's
statetext- For a share made with you: accepted, pending or declined; otherwise empty
urltext- The link to send; empty for a share with people
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
Outputs
deletedtrue/false- True once deleted
pathtext- What was deleted
typetext- file or folder
Example output
{
"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
sharetextRequired - The share's ID, a number, from 'Create share link', 'Share with person' or 'List shares'.
Outputs
deletedtrue/false- True once the share has stopped
idtext- The share's ID
Example output
{
"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
pathtextRequired - The file, such as /Invoices/invoice-1001.pdf.
Outputs
content_typetext- Its type, such as application/pdf
document_reftext- The downloaded file, for a later step's file field
file_nametext- The file's name
modified_attext- When it last changed (ISO 8601, UTC)
pathtext- The file's path
sizenumber- Its size in bytes
texttext- What it says, for a text file of 1 MB or less; otherwise empty
Example output
{
"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
querytextRequired - Part of their name, username or email, such as sam or @example.com.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many
querytext- What was searched for
resultslist- The people and groups found, exact matches first
Example output
{
"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
emailtext- Its email address
free_bytesnumber- Space left, in bytes
groupslist- The groups it's in
nametext- Its full name
quotatext- Its space limit, such as 5 GB; empty when it has none of its own
used_bytesnumber- Space used, in bytes
user_idtext- The account's username
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
Outputs
checksumtext- The file's SHA-1 checksum, which changes with its content; empty for a folder
content_typetext- Its type, such as application/pdf; empty for a folder
etagtext- A tag that changes whenever it does
file_idtext- ownCloud's ID for it, which stays the same when it's moved
linktext- A link that opens it in ownCloud, for people who can see it
modified_attext- When it last changed (ISO 8601, UTC)
nametext- Its name, such as invoice-1001.pdf
ownertext- The name of the person it belongs to
pathtext- Its path, such as /Invoices/invoice-1001.pdf
sharedtrue/false- True when it's shared with people or by a link
sizenumber- Its size in bytes; for a folder, everything in it
typetext- file or folder
Example output
{
"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
foldertext - The folder, such as /Invoices. Leave blank for your top folder.
- Include subfolders
include_subfolderstrue/false - Also list everything in the folders inside it, all the way down (up to 200 folders).Default:
false. - How many
limitnumber - The most to list. Defaults to 100.From 1 to 1000.
Outputs
countnumber- How many are listed
foldertext- The folder listed
itemslist- The files and folders, folders first
moretrue/false- True when there were more than were listed
Example output
{
"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
pathtext - Only shares of this file or folder, such as /Invoices. Leave blank for all.
- Shared with me
shared_with_metrue/false - List what others have shared with you, not what you shared.Default:
false.
Outputs
countnumber- How many
shareslist- The shares, by path
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
- To folder
destination_foldertext - 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_nametext - A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
- Replace
replacetrue/false - Write over anything already there with that name. Off: the step stops and says so.Default:
false.
Outputs
checksumtext- The file's SHA-1 checksum, which changes with its content; empty for a folder
content_typetext- Its type, such as application/pdf; empty for a folder
etagtext- A tag that changes whenever it does
file_idtext- ownCloud's ID for it, which stays the same when it's moved
linktext- A link that opens it in ownCloud, for people who can see it
modified_attext- When it last changed (ISO 8601, UTC)
nametext- Its name, such as invoice-1001.pdf
ownertext- The name of the person it belongs to
pathtext- Its path, such as /Invoices/invoice-1001.pdf
sharedtrue/false- True when it's shared with people or by a link
sizenumber- Its size in bytes; for a folder, everything in it
typetext- file or folder
Example output
{
"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
querytextRequired - Part of the name, such as invoice.
- Folder
foldertext - Only look in this folder and the folders inside it. Leave blank to look everywhere.
- How many
limitnumber - The most to list. Defaults to 100.From 1 to 1000.
Outputs
countnumber- How many
foldertext- The folder searched in; / for everywhere
itemslist- The files and folders found, most recently changed first
querytext- What was searched for
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
- Group
grouptextRequired - The group: pick one of yours, or type its name.
- Access
accesstext - 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_ondate - The day the group's access ends. Leave blank to keep it shared.
Outputs
accesstext- view, edit, or for a folder link, upload (file drop)
can_resharetrue/false- Whether they may share it on
created_attext- When it was shared (ISO 8601, UTC)
expires_ontext- The day it stops working (YYYY-MM-DD); empty if never
has_passwordtrue/false- Whether the link asks for a password
idtext- The share's ID, for 'Delete share'
item_typetext- file or folder
link_nametext- The link's name, shown in ownCloud's sharing panel
nametext- The shared file or folder's name
ownertext- The username of who shared it
owner_nametext- Their full name
pathtext- What it shares, as the person it's shared with sees it
share_typetext- link, user or group
shared_withtext- The username or group it's shared with; empty for a link
shared_with_nametext- Their full name, or the group's
statetext- For a share made with you: accepted, pending or declined; otherwise empty
urltext- The link to send; empty for a share with people
Example output
{
"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
pathtextRequired - The file or folder, such as /Invoices/invoice-1001.pdf.
- Person
usertextRequired - Their username, email or full name, such as sam@example.com.
- Access
accesstext - 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_ondate - The day their access ends. Leave blank to keep it shared.
Outputs
accesstext- view, edit, or for a folder link, upload (file drop)
can_resharetrue/false- Whether they may share it on
created_attext- When it was shared (ISO 8601, UTC)
expires_ontext- The day it stops working (YYYY-MM-DD); empty if never
has_passwordtrue/false- Whether the link asks for a password
idtext- The share's ID, for 'Delete share'
item_typetext- file or folder
link_nametext- The link's name, shown in ownCloud's sharing panel
nametext- The shared file or folder's name
ownertext- The username of who shared it
owner_nametext- Their full name
pathtext- What it shares, as the person it's shared with sees it
share_typetext- link, user or group
shared_withtext- The username or group it's shared with; empty for a link
shared_with_nametext- Their full name, or the group's
statetext- For a share made with you: accepted, pending or declined; otherwise empty
urltext- The link to send; empty for a share with people
Example output
{
"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
foldertext - 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
filetext - The file: upload one, pick a file from an earlier step, or paste a link to one. Use this or Text.
- Text
texttext - Words to save as the file, such as a CSV or notes. Use this or File, and give a file name.
- File name
file_nametext - What to call it, such as invoice-1001.pdf. Leave blank to keep the file's own name.
- Replace
replacetrue/false - Write over a file with the same name. Off: ownCloud keeps both, adding (2) to the new one's name.Default:
false.
Outputs
checksumtext- The file's SHA-1 checksum, which changes with its content; empty for a folder
content_typetext- Its type, such as application/pdf; empty for a folder
etagtext- A tag that changes whenever it does
file_idtext- ownCloud's ID for it, which stays the same when it's moved
linktext- A link that opens it in ownCloud, for people who can see it
modified_attext- When it last changed (ISO 8601, UTC)
nametext- Its name, such as invoice-1001.pdf
ownertext- The name of the person it belongs to
pathtext- Its path, such as /Invoices/invoice-1001.pdf
sharedtrue/false- True when it's shared with people or by a link
sizenumber- Its size in bytes; for a folder, everything in it
typetext- file or folder
Example output
{
"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"
}