share-file

name

share-file

description

ShareFile is a secure file sharing and content collaboration solution that supports workflows for document storage, e-signatures, and encrypted file transfer in professional environments. Read and write ShareFile data through One: items, users, shares, accounts, encryptedemails, reports and more, 336 actions with real parameter documentation. Use whenever the user asks to look something up in ShareFile, create or update a record there, or build code against the ShareFile API.

ShareFile through One

ShareFile is a secure file sharing and content collaboration solution that supports workflows for document storage, e-signatures, and encrypted file transfer in professional environments.

One exposes ShareFile through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform share-file if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm ShareFile is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real ShareFile account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Items

Action	Method	Path	Action id
Download an Item’s Content	GET	/sf/v3/Items({{id}})/Download	conn_mod_def::GJ6ak3UPa7Q::Z3GFM31PSmOInkWb99BM2A
Get a Folder TreeView (Items)	GET	/sf/v3/Items({{id}})	conn_mod_def::GJ6alqnn9pI::Ko5x7fn4RQir0zrcesOLAw
Get a Folder’s Access Info (Effective ACL)	GET	/sf/v3/Items({{id}})/Info	conn_mod_def::GJ6alMMHRm0::7_vUsyOMRZiE2gNAstLXKA
Get an Item by ID	GET	/sf/v3/Items({{id}})	conn_mod_def::GJ6alDsC2vc::2NjDkx76QNOXA4Xpt8kN_Q
Get an Item by ID or Tree View	GET	/sf/v3/Items({{id}})	conn_mod_def::GJ6alFQuIjE::kqjwfBvqRjCR-tecFGiHcg
Get an Item by Path	GET	/sf/v3/Items/ByPath	conn_mod_def::GJ6albo-_qo::Jz5hN_NLTWqNy1FMOU7vtw
Get an Item by Relative Path from an ID	GET	/sf/v3/Items({{id}})/ByPath	conn_mod_def::GJ6alZ93ZsU::eI5-5gv_RFSU41EY-jUAnQ
Get an Item Stream’s Versions (Stream)	GET	/sf/v3/Items({{id}})/Stream	conn_mod_def::GJ6almtnzOQ::xIZ0b9rCQhyOOdZMg8SszQ
Get an Item’s Access Control List (ACL)	GET	/sf/v3/Items({{id}})/AccessControls	conn_mod_def::GJ6aefE4SBg::9LOkbsbGTnCdA9yfiLVczA
Get an Item’s Breadcrumbs	GET	/sf/v3/Items({{id}})/Breadcrumbs	conn_mod_def::GJ6ak7PJrSM::xicivrieS6KwW0qLNS1yBw
Get an Item’s Parent	GET	/sf/v3/Items({{id}})/Parent	conn_mod_def::GJ6alVh3WaE::05c5rvEgS0WWinaBaBB8eg
Get an Item’s Protocol Links	GET

35 more Items actions are available through search.

Users

Action	Method	Path	Action id
Get a User (by ID, by Email Address, or Current User)	GET	/sf/v3/Users	conn_mod_def::GJ6ar4Ho3Qo::0iRrpWJJSX6xgu2w3iC4vA
Get a User (by ID, Email, or Current User)	GET	/sf/v3/Users({{id}})	conn_mod_def::GJ6ar1V948g::HaUVXeaPTui_kSeZayGPAA
Get a User’s FileBox Children	GET	/sf/v3/Users({{id}})/Box	conn_mod_def::GJ6asCT0F6A::fs4qSpCTT0-7AYAlX3VFcQ
Get a User’s FileBox Folder	GET	/sf/v3/Users({{id}})/FileBox	conn_mod_def::GJ6asMs_BiI::dx5UARcPSB-UI1h9rQTh9A
Get a User’s Home Folder	GET	/sf/v3/Users/{{userId}}/HomeFolder	conn_mod_def::GJ6arUt2nG0::mEuzWl3ZTTeKKZrvuc_VuQ
Get a User's Inbox Metadata	GET	/sf/v3/Users/InboxMetadata	conn_mod_def::GJ6arUahu7s::vghqMf3SSWqC32PxaVJH-A
Get a User's Preferences	GET	/sf/v3/Users/Preferences	conn_mod_def::GJ6asChnpkw::k6fDPJJoQ46bTSrzQG6CVg
Get a User’s Preferences	GET	/sf/v3/Users({{id}})/Preferences	conn_mod_def::GJ6asCou9Hg::WMNOjtNyTBaaKFoW8iY-Pg
Get a User’s Security Settings	GET	/sf/v3/Users({{id}})/Security	conn_mod_def::GJ6asBioLcE::FTofuZ82Qd6ITC0bwagneA
Get a User's Sent Messages	GET	/sf/v3/Users({{userId}})/SentMessages	conn_mod_def::GJ6ar3dsNOU::4OPSTnV0Qki7Q5tiA_jPug
Get a User’s Top Folders	GET	/sf/v3/Users({{id}})/TopFolders	conn_mod_def::GJ6asMBMIAE::acSHsjdnR6iQFioTVG_gRw
Get Current User Info	GET

31 more Users actions are available through search.

Shares

Action	Method	Path	Action id
Download a Share’s Items	GET	/sf/v3/Shares({{shareId}})/Download	conn_mod_def::GJ6apEPW1Hw::11k4Sj0uTQ609dszDT0zqQ
Download a Share’s Items	GET	/sf/v3/Shares({{shareId}})/Download	conn_mod_def::GJ6apEDmIss::JAaqKnAbRcuhByLpJfKjNg
Download a Share’s Items (or a Specific Top-Level Item)	GET	/sf/v3/Shares({{shareId}})/Download	conn_mod_def::GJ6apO0Y3y0::JVKM5jrTSHapNa6lStAVLQ
Download a Share’s Items (or a Specific Top-Level Item)	GET	/sf/v3/Shares({{shareId}})/Download({{itemId}})	conn_mod_def::GJ6apTY__7A::HQ-dY4CHSLKoa3nFFj0yOQ
Download Items from a Share for a Recipient (with Alias)	GET	/sf/v3/Shares({{shareId}})/Recipients({{aliasid}})/DownloadWithAlias	conn_mod_def::GJ6apF4RIQc::oueTcimdTl6MDMNmn0AnAA
Get a Recipient’s Shares Inbox	GET	/sf/v3/Shares/Inbox({{id}})	conn_mod_def::GJ6apYRO4Xs::4Xm9LmM7TEiWzDHKmaw2dg
Get a Recipient’s Shares Inbox	GET	/sf/v3/Shares/Inbox	conn_mod_def::GJ6apPA0O60::dCSJvy5ARlSdVIQQ43SiNA
Get a Share	GET	/sf/v3/Shares({{id}})	conn_mod_def::GJ6ap4gFn7g::qIJ69C-lQ8aRwiOFUJ9C3w
Get a Share Item Thumbnail	GET	/sf/v3/Shares({{shareid}})/Items({{itemid}})/Thumbnail	conn_mod_def::GJ6apxKwNmQ::MDmtjGeTTsyWuiG6giCuLg
Get a Share Recipient’s Sent Message Content	GET	/sf/v3/Shares({{shareId}})/Recipients({{aliasId}})/Message	conn_mod_def::GJ6apwDOfYw::fj2VAOHJSomMK55zN_uPYg
Get a Share’s Encrypted Email	GET	/sf/v3/Shares({{id}})/EncryptedEmail

15 more Shares actions are available through search.

Accounts

Action	Method	Path	Action id
Check if WebPop Is Required for an Account	GET	/sf/v3/Accounts/RequireWebPop	conn_mod_def::GJ6aerHaEYk::kGtQHRfoQW2H-jxDkL6AkA
Check Whether a ShareFile Subdomain Is Required for an Account	GET	/sf/v3/Accounts/RequireSubdomain	conn_mod_def::GJ6aetNBHlw::FQdljk6HR1KPmdTG2BVe7g
Get Account Mobile Security Settings	GET	/sf/v3/Accounts/MobileSecuritySettings	conn_mod_def::GJ6afIzi7cg::lf5o7OqOSfqkWFGyE3MdVQ
Get Account Preferences	GET	/sf/v3/Accounts/Preferences	conn_mod_def::GJ6afMiu_lY::p6Ewz1mGQGe9H_IrXYQf3g
Get Account Product Defaults	GET	/sf/v3/Accounts/ProductDefaults	conn_mod_def::GJ6afZJqY9M::9NVsegOhTnKT6_h2FxsMSw
Get an Account’s Folder Access Control Domain List	GET	/sf/v3/Accounts/FolderAccessControlDomains	conn_mod_def::GJ6afvti85U::-NZddyY1Ro6A9_LZOzQ7zQ
Get an Account’s Single Sign-On (SSO) Configuration	GET	/sf/v3/Accounts/SSO	conn_mod_def::GJ6afYHaMY8::xg0iEuWRT62ZYFPkp0Xu7g
Get Current Account (by Account ID)	GET	/sf/v3/Accounts({{id}})	conn_mod_def::GJ6afVBawmk::wA7QQOmBSw6OMpUEyXY4AQ
Get Current Account (by Subdomain)	GET	/sf/v3/Accounts	conn_mod_def::GJ6afUnXAsA::eCPLeEc_RLe2AJxCPvknLQ
Get SSO Info for an Account Subdomain	GET	/sf/v3/Accounts/SSOInfo	conn_mod_def::GJ6afgwvE5I::ookBbxtgRnedVVObRsc8qQ
Get Tenant Zone Usage for an Account	GET	/sf/v3/Accounts/Tenants/ZoneUsage	conn_mod_def::GJ6afsvjRiY::0juwve9xRZeoqPkWCMnsvg

3 more Accounts actions are available through search.

EncryptedEmails

Action	Method	Path	Action id
Download an Encrypted Email’s Message	GET	/sf/v3/EncryptedEmails/{{id}}/Message	conn_mod_def::GJ6ahsd1neA::ajyWWrF1Qae_SSzWwpIcIw
Get an Encrypted Email by ID	GET	/sf/v3/EncryptedEmails({{id}})	conn_mod_def::GJ6ahr5Kfcg::6R64lGtuQQO2nyizPxMUSw
Get an Encrypted Email by ID	GET	/sf/v3/EncryptedEmails({{id}})	conn_mod_def::GJ6ahrlwM2o::1OOf-SCdQ72oA1hyVC1DUA
Get an Encrypted Email Thread’s Messages	GET	/sf/v3/EncryptedEmails({{id}})/Thread	conn_mod_def::GJ6ah9NA8pA::8RpeDsGQQFyChJWFrtUJIQ
Get an Encrypted Email’s Message Thread	GET	/sf/v3/EncryptedEmails({{id}})/Thread	conn_mod_def::GJ6aiI6U2cI::pnlLDCDQQ1iLHtylZ3nxsg
Authorize an Encrypted Email	POST	/sf/v3/EncryptedEmails({{id}})/Authorize	conn_mod_def::GJ6ahjy9tEg::yqHwEkD2T3K4mtg22ICRzA
Authorize an Encrypted Email	POST	/sf/v3/EncryptedEmails/{{id}}/Authorize	conn_mod_def::GJ6ahakbhPA::GqoyEfosT2Gbg1hD_g-eFA
Create an Encrypted Email	POST	/sf/v3/EncryptedEmails	conn_mod_def::GJ6ahbcnKBM::EKuPYWkARA62QaJ4qKC9kQ
Delete an Encrypted Email	DELETE	/sf/v3/EncryptedEmails({{id}})	conn_mod_def::GJ6ahwKdmd0::-efoghn7TSK4mGDSZFyUHw
Reply All to an Encrypted Email (Create Reply Draft)	POST	/sf/v3/EncryptedEmails({{id}})/ReplyAll	conn_mod_def::GJ6ah3uhZ-8::qicxINPBRmyOjNna9IXbuw
Reply to an Encrypted Email (Create Reply Draft)	POST	/sf/v3/EncryptedEmails({{id}})/Reply	conn_mod_def::GJ6ah3qqAAY::iGqTTu-sSAyT4b7hYiORMA

1 more EncryptedEmails actions are available through search.

Reports

Action	Method	Path	Action id
Get a Report by ID	GET	/sf/v3/Reports({{id}})	conn_mod_def::GJ6aoEr2kJ0::uEgQS_AWSP6X6nWr5nmB8A
Get a Report Record by ID	GET	/sf/v3/Reports/Record({{id}})	conn_mod_def::GJ6aoGQhoMI::0B_V93IXS0GqLYOz8MK48Q
Get a Report Record’s JSON Data	GET	/sf/v3/Reports/Records({{id}})/GetJsonData	conn_mod_def::GJ6any5_D5Q::fru24JeIRUq5ZMcRXMxJEA
Get a Report’s Records	GET	/sf/v3/Reports({{id}})/Records	conn_mod_def::GJ6an1RpM40::MB6kNq9zRYSDjD4egwokOw
Get Recent Reports for the Current Account	GET	/sf/v3/Reports/Recent	conn_mod_def::GJ6antFq9xs::G4g8d71qRNauFD3Ypskd3g
Get Reports for the Current Account	GET	/sf/v3/Reports	conn_mod_def::GJ6an-dD5c0::aeZk5MWmRRSmnQl5oW94Hg
Run a Report	GET	/sf/v3/Reports/{{id}}/Run	conn_mod_def::GJ6aoNjsbqI::eZ1dKS9OQlyT--u6nt8zuA
Create a Report	POST	/sf/v3/Reports	conn_mod_def::GJ6anYs4xJI::vM65ti_5Q6izAMW7ZP9JPw
Delete a Report	DELETE	/sf/v3/Reports/{{id}}	conn_mod_def::GJ6anwpogic::vT1PVMYqTqiP-TSlahg1_g
Get a Report Preview Location	POST	/sf/v3/Reports({{reportId}})/Preview	conn_mod_def::GJ6ans4mDac::4lqHdyp0TvaYuaTCJcKkOg
Move a Report to a Folder	POST	/sf/v3/Reports({{reportId}})/Move	conn_mod_def::GJ6aoODoIFU::CPFG_68nSsub1n2l_qc_LQ
Update a Report	PATCH	/sf/v3/Reports

ConnectorGroups

Action	Method	Path	Action id
Get a Connector Group by Provider	GET	/sf/v3/ConnectorGroups/ByProvider	conn_mod_def::GJ6ahCTcid0::jD4d_pJ9TXWRdSVWiS0AJA
Get a Connector Group by Service ID	GET	/sf/v3/ConnectorGroups({{id}})	conn_mod_def::GJ6ahD4V6rQ::dOFyBNDKTDWGruZTfQef2g
Get a Connector Group’s Symbolic Links (Children)	GET	/sf/v3/ConnectorGroups({{id}})/Children	conn_mod_def::GJ6almSwBbw::scs_UCDSSwSeEFOcxjg9KQ
Get a Connector Group’s Zone by Service ID and Zone ID	GET	/sf/v3/ConnectorGroups({{serviceid}})/Zones({{zoneid}})	conn_mod_def::GJ6ag9uckgE::pX8N90cuRI2Ws-FOqH1bMA
Get Connector Groups in a Zone	GET	/sf/v3/ConnectorGroups/GetByZone({{zoneid}})	conn_mod_def::GJ6ag8v4W64::HXoIN2bhRmePjNnVhQZiAg
List a Connector Group’s Storage Centers in a Zone	GET	/sf/v3/ConnectorGroups({{id}})/Zones({{zoneid}})/StorageCenters	conn_mod_def::GJ6ahLSYDsA::5qvVfHOqRdWm866hdv71MQ
List Connector Groups in the Account	GET	/sf/v3/ConnectorGroups	conn_mod_def::GJ6agwFp8PY::GvukRV1QT7evqKitCqqjCA
Add a Connector Group to a Storage Center (in a Zone)	POST	/sf/v3/ConnectorGroups({{id}})/Zones({{zoneid}})/StorageCenters	conn_mod_def::GJ6ag14tGm0::gRLvtPfpQ0meQassEhuD2g
Create a Connector Group Associated With a Zone	POST	/sf/v3/ConnectorGroups	conn_mod_def::GJ6agxR1R_E::JipHYPk2RQasVzvdPMYK9w
Remove a Connector Group	DELETE	/sf/v3/ConnectorGroups({{id}})	conn_mod_def::GJ6ahLUEArs::8XWem36aRpODreoSXg54NQ
Remove a Connector Group’s Zone Association	DELETE

Groups

Action	Method	Path	Action id
Export a Group’s Contacts as a Document	GET	/sf/v3/Groups({{id}})/ExportDocument	conn_mod_def::GJ6ajt2Z9FQ::a0heIvMuTI-4Obo1z1c4nw
Get a Group by ID	GET	/sf/v3/Groups({{id}})	conn_mod_def::GJ6ajuMuEQw::CqHc8mGSQYSBmNKnADU0_g
List a Group’s Contacts	GET	/sf/v3/Groups({{id}})/Contacts	conn_mod_def::GJ6aj1bPm9U::6VZzTNhESMiAsug3vRcG9w
List Distribution Groups	GET	/sf/v3/Groups	conn_mod_def::GJ6aj4FBww8::JCnXgFPqQFefFr8UyfVhDA
Retrieve an Authenticated User’s Groups	GET	/sf/v3/Users({{id}})/Groups	conn_mod_def::GJ6aj84cZas::7mp4_qquR_WYlDM8GzF91A
Add Contacts to a Group	POST	/sf/v3/Groups({{id}})/Contacts	conn_mod_def::GJ6ajpJpvpE::OhrU_Sb7T4ag-ngfrrm1Wg
Create a Group	POST	/sf/v3/Groups	conn_mod_def::GJ6ajo3SSo8::t4tEfkidSe-4oHR5yFdfXQ

3 more Groups actions are available through search.

This lists 90 of 336 actions. For anything not here, call search_one_platform_actions with platform share-file. The full catalog is at https://www.withone.ai/knowledge/share-file.

When a call fails

The error comes from ShareFile, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/share-file

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.