Organize Brault libraries, folders and files, run boards, comments and pages, and share or transfer files.
Explore 90 workflow actions for Brault, including account permissions and operation limits.
35 read actions55 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add files to a board
Write
Every id is either added or already on the board.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Append blocks to a page
Write
Appends at the end of the live document, through the collaboration server, so open editors receive it immediately.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Comment on a file
Write
Mention a member with the inline token [@ ]; the response lists the mentions that resolved.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Copy a file
Write
Give exactly one of library_id, folder_id, to_root.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a board
Write
Create a board.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a board property
Write
Create a board property.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a brandspace property
Write
Create a brandspace property.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a folder
Write
Create a folder.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a library
Write
Create a library.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a page
Write
Give exactly one of library_id, folder_id, to_root.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a shared link
Write
One call: target, access, password, expiry, anonymous comments and (for a board) the views.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a transfer
Write
Send Brault files and folders as a transfer in one call. Uploading new files into a transfer is not offered.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create an option (board property)
Write
status and multi_tag properties only.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create an option (brandspace property)
Write
tag properties only.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Current usage
Read
Counters for the current windows and the monthly quota of the brandspace.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Delete a board
Write
Permanent: there is no trash for boards.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a board property
Write
Its options and every value files hold for it go with it.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a brandspace property
Write
Its options and every value files hold for it go with it.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a comment
Write
The author, or an owner or admin of the brandspace.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a library
Write
Delete a library.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a reply
Write
The author, or an owner or admin of the brandspace.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a shared link
Write
Permanent. Visitors holding the URL lose access at once.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a version
Write
Irreversible: the version's bytes and every comment attached to it are deleted.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete an option (board property)
Write
Clears it from every file's value: a status value pointing at it becomes unset, a multi_tag value loses that tag.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete an option (brandspace property)
Write
Delete an option.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a comment's text
Write
The author only.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a reply's text
Write
The author only.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Expire a transfer
Write
Recipients lose access at once.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Finalize a transfer
Write
Every declared upload must be completed first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Find visually similar files
Read
Nearest neighbours of this file's embedding.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Import a file from a URL
Write
Downloads a public http(s) URL into the brandspace.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
List a comment's replies
Read
Oldest first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List a file's comments
Read
Oldest first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List a file's versions
Read
Newest first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List board members
Read
User ids only: everyone with an explicit grant plus everyone whose brandspace role carries boards.manage_all.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List board properties
Read
In position order, each with its options.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List boards
Read
Boards of the brandspace the key's creator can see: every board when their role carries boards.manage_all, otherwise only the boards they were granted.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List brandspace properties
Read
In position order, each with its options.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List files
Read
Files the key's creator can see.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List folders
Read
The folder tree the key's creator can see.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List libraries
Read
Libraries the key's creator can see.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List members
Read
Members of the brandspace with their role.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List pages
Read
Pages the key's creator can see, newest first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List roles
Read
List roles.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List shared links
Read
The brandspace's links, newest first.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List the boards a file is on
Read
Only the boards the key's creator can see.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
List transfers
Read
The brandspace's transfers, newest first, with any open drafts interleaved by creation time.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Make a version the active one
Write
Make a version the active one.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Move a file
Write
Give exactly one of library_id, folder_id, to_root.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Move a folder
Write
Give exactly one of library_id, folder_id.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Publish a page
Write
Anyone holding the page's public_url can read it.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Query the files on a board
Read
A read expressed as POST because its filter is a JSON document.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Remove a file from a board
Write
Removes the membership and this board's values for the file.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename a board property
Write
A property's type and position are fixed.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename or recolor a folder
Write
Rename or recolor a folder.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reopen a comment
Write
Clears resolved_by_id; a reopened comment carries no "reopened at".
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to a comment
Write
Reply to a comment.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Resolve a comment
Write
Anyone who can view the file.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Restore a trashed file
Write
Restore a trashed file.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Restore a trashed folder
Write
Restore a trashed folder.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Retrieve a board
Read
The board plus its properties and their options.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a board property
Read
Retrieve a board property.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a brandspace property
Read
Retrieve a brandspace property.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a comment
Read
Retrieve a comment.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a file
Read
Full metadata plus renditions signed for 15 minutes.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a folder
Read
Retrieve a folder.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a library
Read
Retrieve a library.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a member
Read
Retrieve a member.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a page
Read
The page plus its content.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a shared link
Read
Retrieve a shared link.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve a transfer
Read
With its files and folders, and a fresh zip URL.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve an import
Read
Retrieve an import.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Retrieve the brandspace this key belongs to
Read
Available to every key, whatever its scopes.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Search files and folders
Read
Keyword, semantic and natural-language search over everything the key's creator can see.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Set or clear a board property value
Write
Send exactly one field, named after the property's type.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set or clear a brandspace property value on a file
Write
Send exactly one field, named after the property's type.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
The webhook event catalogue
Read
Every event type a webhook endpoint can subscribe to, with its group, a one-line description and the object its payload's data carries.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
Trash or permanently delete a file
Write
Moves the file to the trash.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Trash or permanently delete a folder
Write
Moves the folder to the trash.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Trash or permanently delete a page
Write
Moves the page to the trash.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unpublish a page
Write
Withdraws the public URL.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a board
Write
name, color and emoji are applied first; pinned is applied after them.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a brandspace property
Write
Update a brandspace property.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a file
Write
Rename, replace the tag set, or point a link file at a new URL.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a library
Write
Only name and description are settable.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a shared link
Write
Fields are applied in a fixed order and the first failure stops the sequence - the fields already applied stay applied.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a transfer
Write
Set or clear the password, and/or move the expiry.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an option (board property)
Write
Update an option.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update an option (brandspace property)
Write
Update an option.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
A repeated request may repeat the external action. Review the previous result before retrying a write.
Who am I
Read
The brandspace, the key's creator, plan and limits behind the API key, and which host serves the brandspace's content.
Permissions and limits
Account permissions
A Brault API key (bsk_) with the scope the call needs
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Brault. A saved workflow is not a completed provider action.