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

ActionWhat it does
Copy file or folderCopy a file or folder to another folder, under a new name, or both.
Create folderMake a folder, and any folders above it that aren't there yet.
Create share linkMake 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 folderDelete a file or folder.
Delete shareStop a share you made: a link stops working, or people lose access.
Download fileDownload a file for later steps, such as attaching it to an email.
Find people to share withFind people and groups on your ownCloud by name, username or email, to share with.
Get accountWho the connection signs in as, the groups they're in, and how much space is used and left.
Get file detailsLook up a file or folder: its size, type, when it last changed, who it belongs to, and its link.
List folderList the files and folders in a folder, folders first, with their sizes and when they changed.
List sharesList the links and shares you made, of one file or folder or all of them, or what others have shared with you.
Move or renameMove a file or folder to another folder, give it a new name, or both.
Search filesFind files and folders whose name contains some words, most recently changed first.
Share with groupShare a file or folder with everyone in an ownCloud group.
Share with personShare a file or folder with someone who has an account on the same ownCloud.
Upload filePut 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

PathpathtextRequired
The file or folder, such as /Invoices/invoice-1001.pdf.
To folderdestination_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 namenew_nametext
A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
Replacereplacetrue/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

PathpathtextRequired
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"
}

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

PathpathtextRequired
The file or folder, such as /Invoices/invoice-1001.pdf.
Accessaccesstext
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.
Passwordpasswordtext
A password the link asks for. Leave blank for none, unless your server requires one.
Expiresexpires_ondate
The day the link stops working. Leave blank to keep it working, unless your server sets a limit.
Link namelink_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

PathpathtextRequired
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 IDsharetextRequired
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

PathpathtextRequired
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 emailquerytextRequired
Part of their name, username or email, such as sam or @example.com.
How manylimitnumber
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

PathpathtextRequired
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

Folderfoldertext
The folder, such as /Invoices. Leave blank for your top folder.
Include subfoldersinclude_subfolderstrue/false
Also list everything in the folders inside it, all the way down (up to 200 folders).Default: false.
How manylimitnumber
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

Pathpathtext
Only shares of this file or folder, such as /Invoices. Leave blank for all.
Shared with meshared_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

PathpathtextRequired
The file or folder, such as /Invoices/invoice-1001.pdf.
To folderdestination_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 namenew_nametext
A new name for it, such as invoice-1001-paid.pdf. Leave blank to keep its name.
Replacereplacetrue/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 containsquerytextRequired
Part of the name, such as invoice.
Folderfoldertext
Only look in this folder and the folders inside it. Leave blank to look everywhere.
How manylimitnumber
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

PathpathtextRequired
The file or folder, such as /Invoices/invoice-1001.pdf.
GroupgrouptextRequired
The group: pick one of yours, or type its name.
Accessaccesstext
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.
Expiresexpires_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

PathpathtextRequired
The file or folder, such as /Invoices/invoice-1001.pdf.
PersonusertextRequired
Their username, email or full name, such as sam@example.com.
Accessaccesstext
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.
Expiresexpires_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

Folderfoldertext
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.
Filefiletext
The file: upload one, pick a file from an earlier step, or paste a link to one. Use this or Text.
Texttexttext
Words to save as the file, such as a CSV or notes. Use this or File, and give a file name.
File namefile_nametext
What to call it, such as invoice-1001.pdf. Leave blank to keep the file's own name.
Replacereplacetrue/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"
}

On this page