Datasite

App · 20 actions

Work with your Datasite data rooms from a workflow: find projects, organize filerooms and folders, upload, search, rename and publish documents, invite people and turn their access on or off, run Q&A, and start workflows when documents, questions or people arrive.

Actions

ActionWhat it does
Activate or deactivate userTurn someone's access to a project on or off, such as when a bidder leaves the deal.
Ask questionAsk a question in a project's Q&A, optionally about specific documents.
Close or reopen questionClose a Q&A question, or reopen a closed one.
Create fileroomAdd a fileroom to a project.
Create folderCreate a folder inside a fileroom or another folder.
Delete document or folderDelete a document, folder or fileroom from a project.
Delete questionDelete a Q&A question, saying why.
Get document or folderGet a document, folder or fileroom: its name, index number, where it sits, whether it is published and when it last changed.
Get projectGet a project's name, product, state and where it is stored.
Get questionGet a Q&A question with its whole thread of posts.
Invite userInvite someone to a project with a role.
List fileroomsList a project's filerooms, the top level of its index.
List folder contentsList the documents and folders directly inside a fileroom or folder.
List people in projectList the people invited to a project, with their status and role.
List projectsList the Datasite projects (data rooms) the connected person can open, with each one's product and state.
List questionsList the Q&A questions in a project that the connected person can see.
List rolesList a project's roles, which decide what each person invited to it can see and do.
Search documentsSearch a project's documents by the words in them or their names, newest first.
Update document or folderRename a document, folder or fileroom, or publish or unpublish it.
Upload documentAdd a file to a fileroom or folder as a new document.

Activate or deactivate user

Turn someone's access to a project on or off, such as when a bidder leaves the deal.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Personparticipant_idtextRequired
Pick someone in the project, or give their user ID from an earlier step.
AccessaccesstextRequired
Activate or deactivate their access.One of: ACTIVATED (Activate), DEACTIVATED (Deactivate).

Outputs

participantobject
The person
project_idtext
The project it is in
Example output
{
  "participant": {
    "email": "jane.doe@example.com",
    "first_name": "Jane",
    "last_name": "Doe",
    "role_id": "6400aa11bb22cc33dd44ee55",
    "status": "DEACTIVATED",
    "user_id": "5b3a46ab89cf1300102bef69"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

Ask question

Ask a question in a project's Q&A, optionally about specific documents.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
QuestionquestiontextRequired
What to ask.
Categorycategory_idtext
The question's category. Leave empty for none.
Priorityprioritytrue/false
Turn on to mark it as a priority question.Default: false.
About documentsdocument_idstext
IDs of documents the question is about, separated by commas. Leave empty for none.

Outputs

project_idtext
The project it is in
questionobject
The question
Example output
{
  "project_id": "5f6bae25cacf456aacc4c535",
  "question": {
    "answer": "",
    "asked_at": "2026-10-15T10:00:00Z",
    "asked_by": "John Smith (john.smith@example.com)",
    "assigned_to": "Jane Doe (jane.doe@example.com)",
    "category_id": "6522a0229c1e4b0012ab3501",
    "category_name": "Tax",
    "closed": false,
    "id": "6522a0119c1e4b0012ab3500",
    "last_activity_at": "2026-10-15T10:00:00Z",
    "number": 12,
    "posts": [
      {
        "content": "Please share the 2025 tax filings.",
        "created_at": "2026-10-15T10:00:00Z",
        "created_by": "John Smith (john.smith@example.com)",
        "id": "6522a0339c1e4b0012ab3502",
        "status": "SUBMITTED",
        "type": "QUESTION"
      }
    ],
    "priority": false,
    "question": "Please share the 2025 tax filings.",
    "status": "SUBMITTED",
    "team_name": "Bidder A",
    "unread": true
  }
}

Close or reopen question

Close a Q&A question, or reopen a closed one.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Questionquestion_idtextRequired
Pick a question, or give its ID from a trigger or an earlier step.
Closedclosedtrue/false
On closes the question; off reopens it.Default: true.

Outputs

project_idtext
The project it is in
questionobject
The question
Example output
{
  "project_id": "5f6bae25cacf456aacc4c535",
  "question": {
    "answer": "",
    "asked_at": "2026-10-15T10:00:00Z",
    "asked_by": "John Smith (john.smith@example.com)",
    "assigned_to": "Jane Doe (jane.doe@example.com)",
    "category_id": "6522a0229c1e4b0012ab3501",
    "category_name": "Tax",
    "closed": true,
    "id": "6522a0119c1e4b0012ab3500",
    "last_activity_at": "2026-10-15T10:00:00Z",
    "number": 12,
    "posts": [
      {
        "content": "Please share the 2025 tax filings.",
        "created_at": "2026-10-15T10:00:00Z",
        "created_by": "John Smith (john.smith@example.com)",
        "id": "6522a0339c1e4b0012ab3502",
        "status": "SUBMITTED",
        "type": "QUESTION"
      }
    ],
    "priority": false,
    "question": "Please share the 2025 tax filings.",
    "status": "SUBMITTED",
    "team_name": "Bidder A",
    "unread": true
  }
}

Create fileroom

Add a fileroom to a project. It stays unpublished unless you publish it.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Fileroom namenametextRequired
The fileroom's name.
Publishpublishedtrue/false
Turn on to publish it now, so people with access can see it. Off keeps it unpublished.Default: false.

Outputs

fileroomobject
The new fileroom
project_idtext
The project it is in
Example output
{
  "fileroom": {
    "available_at": "2026-10-14T13:27:53Z",
    "file_id": "",
    "file_type": "",
    "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
    "fileroom_name": "Financials",
    "id": "6511f0aa9c1e4b0012ab34cd",
    "index": "1",
    "modified_at": "2026-10-14T13:27:53Z",
    "name": "Financials",
    "path": "",
    "publishing_status": "UNPUBLISHED",
    "read": false,
    "status": "",
    "type": "FILEROOM"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

Create folder

Create a folder inside a fileroom or another folder. It stays unpublished unless you publish it.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Put it inparent_idtextRequired
The fileroom or folder to create it in. Pick one, or give its ID from an earlier step.
Folder namenametextRequired
The folder's name.
Publishpublishedtrue/false
Turn on to publish it now, so people with access can see it. Off keeps it unpublished.Default: false.
Hide from everyonehiddentrue/false
Turn on to hide it from every role. Off gives it the permissions of the folder it is in.Default: false.

Outputs

folderobject
The new folder
project_idtext
The project it is in
Example output
{
  "folder": {
    "available_at": "2026-10-14T13:27:53Z",
    "file_id": "",
    "file_type": "",
    "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
    "fileroom_name": "Financials",
    "id": "6511f0bb9c1e4b0012ab34ce",
    "index": "1.1",
    "modified_at": "2026-10-14T13:27:53Z",
    "name": "Tax",
    "path": "",
    "publishing_status": "UNPUBLISHED",
    "read": false,
    "status": "",
    "type": "FOLDER"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

Delete document or folder

Delete a document, folder or fileroom from a project.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Document or folderitem_idtextRequired
Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.

Outputs

deletedtrue/false
True once it is deleted
item_idtext
What was deleted
project_idtext
The project it is in
Example output
{
  "deleted": true,
  "item_id": "6511f0cc9c1e4b0012ab34cf",
  "project_id": "5f6bae25cacf456aacc4c535"
}

Delete question

Delete a Q&A question, saying why.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Questionquestion_idtextRequired
Pick a question, or give its ID from a trigger or an earlier step.
ReasonreasontextRequired
Why it is being deleted.One of: DUPLICATE, INACCURATE, CONFIDENTIAL_DISCLOSURE (Confidential disclosure), TEST_QUESTION (Test question), TEAM_INSTRUCTION (Team instruction), OTHER.

Outputs

deletedtrue/false
True once it is deleted
project_idtext
The project it is in
question_idtext
The question deleted
Example output
{
  "deleted": true,
  "project_id": "5f6bae25cacf456aacc4c535",
  "question_id": "6522a0119c1e4b0012ab3500"
}

Get document or folder

Get a document, folder or fileroom: its name, index number, where it sits, whether it is published and when it last changed.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Document or folderitem_idtextRequired
Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.

Outputs

itemobject
The document or folder
project_idtext
The project it is in
Example output
{
  "item": {
    "available_at": "2026-10-14T13:27:53Z",
    "file_id": "6511f0dd9c1e4b0012ab34d0",
    "file_type": "pdf",
    "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
    "fileroom_name": "Financials",
    "id": "6511f0cc9c1e4b0012ab34cf",
    "index": "1.1.1",
    "modified_at": "2026-10-14T13:27:53Z",
    "name": "Audited accounts 2025.pdf",
    "path": "Financials > Tax",
    "publishing_status": "PUBLISHED",
    "read": false,
    "status": "DONE",
    "type": "DOCUMENT"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

Get project

Get a project's name, product, state and where it is stored.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.

Outputs

projectobject
The project
Example output
{
  "project": {
    "datacenter": "USA",
    "drm_enabled": false,
    "id": "5f6bae25cacf456aacc4c535",
    "launch_state": "LAUNCHED",
    "name": "Project Atlas",
    "product": "DILIGENCE",
    "state": "ACTIVE",
    "subscription_id": "64b7f0c2e4b0a1d2c3f4a5b6"
  }
}

Get question

Get a Q&A question with its whole thread of posts.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Questionquestion_idtextRequired
Pick a question, or give its ID from a trigger or an earlier step.
Mark as readmark_as_readtrue/false
Turn on to mark it read for the connected person. Off leaves it as it is.Default: false.

Outputs

project_idtext
The project it is in
questionobject
The question
Example output
{
  "project_id": "5f6bae25cacf456aacc4c535",
  "question": {
    "answer": "",
    "asked_at": "2026-10-15T10:00:00Z",
    "asked_by": "John Smith (john.smith@example.com)",
    "assigned_to": "Jane Doe (jane.doe@example.com)",
    "category_id": "6522a0229c1e4b0012ab3501",
    "category_name": "Tax",
    "closed": false,
    "id": "6522a0119c1e4b0012ab3500",
    "last_activity_at": "2026-10-15T10:00:00Z",
    "number": 12,
    "posts": [
      {
        "content": "Please share the 2025 tax filings.",
        "created_at": "2026-10-15T10:00:00Z",
        "created_by": "John Smith (john.smith@example.com)",
        "id": "6522a0339c1e4b0012ab3502",
        "status": "SUBMITTED",
        "type": "QUESTION"
      }
    ],
    "priority": false,
    "question": "Please share the 2025 tax filings.",
    "status": "SUBMITTED",
    "team_name": "Bidder A",
    "unread": true
  }
}

Invite user

Invite someone to a project with a role. Datasite emails them the invitation.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
EmailemailtextRequired
The email address to invite.
Rolerole_idtextRequired
The role to give them. Pick one, or give its ID from an earlier step.
Invitation languagelanguagetext
The language of the invitation email.One of: en (English), de (German), es (Spanish), fr (French), it (Italian), ja (Japanese), ko (Korean), pl (Polish), pt (Portuguese), ru (Russian), and 6 more. Default: en.
Side of the dealsidetext
Whether they are on the buy side or the sell side. Leave empty to not say.One of: BUYER (Buy side), SELLER (Sell side), NOT_APPLICABLE (Neither).

Outputs

emailtext
The address invited
project_idtext
The project it is in
role_idtext
The role they were given
user_idtext
Their Datasite user ID
Example output
{
  "email": "jane.doe@example.com",
  "project_id": "5f6bae25cacf456aacc4c535",
  "role_id": "6400aa11bb22cc33dd44ee55",
  "user_id": "5b3a46ab89cf1300102bef69"
}

List filerooms

List a project's filerooms, the top level of its index.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.

Outputs

countnumber
How many are in this answer
fileroomslist
The filerooms
project_idtext
The project it is in
Example output
{
  "count": 1,
  "filerooms": [
    {
      "available_at": "2026-10-14T13:27:53Z",
      "file_id": "",
      "file_type": "",
      "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
      "fileroom_name": "Financials",
      "id": "6511f0aa9c1e4b0012ab34cd",
      "index": "1",
      "modified_at": "2026-10-14T13:27:53Z",
      "name": "Financials",
      "path": "",
      "publishing_status": "UNPUBLISHED",
      "read": false,
      "status": "",
      "type": "FILEROOM"
    }
  ],
  "project_id": "5f6bae25cacf456aacc4c535"
}

List folder contents

List the documents and folders directly inside a fileroom or folder.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Fileroom or folderfolder_idtextRequired
Pick one, or give its ID from an earlier step.
Show onlyitem_typetext
Only list documents, folders or placeholders. Leave empty for all.One of: DOCUMENT (Documents), FOLDER (Folders), PLACEHOLDER (Placeholders).

Outputs

countnumber
How many are in this answer
folder_idtext
The fileroom or folder listed
itemslist
What is in it
project_idtext
The project it is in
Example output
{
  "count": 2,
  "folder_id": "6511f0aa9c1e4b0012ab34cd",
  "items": [
    {
      "available_at": "2026-10-14T13:27:53Z",
      "file_id": "",
      "file_type": "",
      "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
      "fileroom_name": "Financials",
      "id": "6511f0bb9c1e4b0012ab34ce",
      "index": "1.1",
      "modified_at": "2026-10-14T13:27:53Z",
      "name": "Tax",
      "path": "",
      "publishing_status": "UNPUBLISHED",
      "read": false,
      "status": "",
      "type": "FOLDER"
    },
    {
      "available_at": "2026-10-14T13:27:53Z",
      "file_id": "6511f0dd9c1e4b0012ab34d0",
      "file_type": "pdf",
      "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
      "fileroom_name": "Financials",
      "id": "6511f0cc9c1e4b0012ab34cf",
      "index": "1.1.1",
      "modified_at": "2026-10-14T13:27:53Z",
      "name": "Audited accounts 2025.pdf",
      "path": "Financials > Tax",
      "publishing_status": "PUBLISHED",
      "read": false,
      "status": "DONE",
      "type": "DOCUMENT"
    }
  ],
  "project_id": "5f6bae25cacf456aacc4c535"
}

List people in project

List the people invited to a project, with their status and role.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Statusstatustext
Only people with this status. Leave empty for everyone.One of: ACTIVATED (Active), INVITED, DEACTIVATED, DRAFTED, EXPIRED.
Rolerole_idtext
Only people with this role. Leave empty for every role.

Outputs

countnumber
How many are in this answer
participantslist
The people
project_idtext
The project it is in
Example output
{
  "count": 1,
  "participants": [
    {
      "email": "jane.doe@example.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "role_id": "6400aa11bb22cc33dd44ee55",
      "status": "ACTIVATED",
      "user_id": "5b3a46ab89cf1300102bef69"
    }
  ],
  "project_id": "5f6bae25cacf456aacc4c535"
}

List projects

List the Datasite projects (data rooms) the connected person can open, with each one's product and state.

Inputs

Productproducttext
Only projects in this Datasite product. Leave empty for all.One of: DILIGENCE, PREPARE, ACQUIRE, OUTREACH, PIPELINE, ARCHIVE, OTHER.
Statestatetext
Only projects in this state. Leave empty for all.One of: NEW, PREP (Preparation), BUILD, ACTIVE, HIBERNATION, SUSPENDED, CLOSURE_REQUESTED (Closure requested), CLOSED.
Name containsname_containstext
Only projects whose name contains these words. Leave empty for all.

Outputs

countnumber
How many are in this answer
projectslist
The projects
Example output
{
  "count": 1,
  "projects": [
    {
      "datacenter": "USA",
      "drm_enabled": false,
      "id": "5f6bae25cacf456aacc4c535",
      "launch_state": "LAUNCHED",
      "name": "Project Atlas",
      "product": "DILIGENCE",
      "state": "ACTIVE",
      "subscription_id": "64b7f0c2e4b0a1d2c3f4a5b6"
    }
  ]
}

List questions

List the Q&A questions in a project that the connected person can see.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Open or closedstatetext
Only open or only closed questions. Leave empty for both.One of: open, closed.

Outputs

countnumber
How many are in this answer
project_idtext
The project it is in
questionslist
The questions
Example output
{
  "count": 1,
  "project_id": "5f6bae25cacf456aacc4c535",
  "questions": [
    {
      "answer": "",
      "asked_at": "2026-10-15T10:00:00Z",
      "asked_by": "John Smith (john.smith@example.com)",
      "assigned_to": "Jane Doe (jane.doe@example.com)",
      "category_id": "6522a0229c1e4b0012ab3501",
      "category_name": "Tax",
      "closed": false,
      "id": "6522a0119c1e4b0012ab3500",
      "last_activity_at": "2026-10-15T10:00:00Z",
      "number": 12,
      "posts": [],
      "priority": false,
      "question": "Please share the 2025 tax filings.",
      "status": "SUBMITTED",
      "team_name": "Bidder A",
      "unread": true
    }
  ]
}

List roles

List a project's roles, which decide what each person invited to it can see and do.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.

Outputs

countnumber
How many are in this answer
project_idtext
The project it is in
roleslist
The roles
Example output
{
  "count": 1,
  "project_id": "5f6bae25cacf456aacc4c535",
  "roles": [
    {
      "created_at": "2026-09-01T09:00:00Z",
      "id": "6400aa11bb22cc33dd44ee55",
      "modified_at": "2026-09-01T09:00:00Z",
      "name": "Buyer reviewer"
    }
  ]
}

Search documents

Search a project's documents by the words in them or their names, newest first. Put a phrase in quotes for an exact match, and use * to match part of a word.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Search forquerytextRequired
The words to look for.
Added afteradded_afterdate and time
Only documents added after this. Leave empty for any time.
Added beforeadded_beforedate and time
Only documents added before this. Leave empty for any time.
Most resultslimitnumber
How many documents to return at most, up to 1000.From 1 to 1000. Default: 100.

Outputs

countnumber
How many are in this answer
documentslist
The documents found
project_idtext
The project it is in
Example output
{
  "count": 1,
  "documents": [
    {
      "available_at": "2026-10-14T13:27:53Z",
      "file_id": "6511f0dd9c1e4b0012ab34d0",
      "file_type": "pdf",
      "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
      "fileroom_name": "Financials",
      "id": "6511f0cc9c1e4b0012ab34cf",
      "index": "1.1.1",
      "modified_at": "2026-10-14T13:27:53Z",
      "name": "Audited accounts 2025.pdf",
      "path": "",
      "publishing_status": "PUBLISHED",
      "read": false,
      "snippet": "2025 tax return",
      "status": "DONE",
      "type": "DOCUMENT"
    }
  ],
  "project_id": "5f6bae25cacf456aacc4c535"
}

Update document or folder

Rename a document, folder or fileroom, or publish or unpublish it. Fields left empty keep their value.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Document or folderitem_idtextRequired
Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.
New namenametext
Its new name. Leave empty to keep it.
Publishingpublishingtext
Publish or unpublish it. Leave empty to keep it as it is.One of: PUBLISHED (Publish), UNPUBLISHED (Unpublish).

Outputs

itemobject
The document or folder
project_idtext
The project it is in
Example output
{
  "item": {
    "available_at": "2026-10-14T13:27:53Z",
    "file_id": "6511f0dd9c1e4b0012ab34d0",
    "file_type": "pdf",
    "fileroom_id": "6511f0aa9c1e4b0012ab34cd",
    "fileroom_name": "Financials",
    "id": "6511f0cc9c1e4b0012ab34cf",
    "index": "1.1.1",
    "modified_at": "2026-10-14T13:27:53Z",
    "name": "Audited accounts 2025.pdf",
    "path": "Financials > Tax",
    "publishing_status": "PUBLISHED",
    "read": false,
    "status": "DONE",
    "type": "DOCUMENT"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

Upload document

Add a file to a fileroom or folder as a new document. It stays unpublished unless you publish it.

Inputs

Projectproject_idtextRequired
The Datasite project (data room). Pick one, or give its ID from an earlier step.
Fileroom or folderfolder_idtextRequired
Where to put it. Pick one, or give its ID from an earlier step.
FilefiletextRequired
The file: upload one, pick one an earlier step made, or paste a public link to one.
File namenametext
The document's name in Datasite, with its extension. Leave empty to use the file's own name.
Publishpublishedtrue/false
Turn on to publish it now, so people with access can see it. Off keeps it unpublished.Default: false.
Hide from everyonehiddentrue/false
Turn on to hide it from every role. Off gives it the permissions of the folder it is in.Default: false.

Outputs

documentobject
The new document
project_idtext
The project it is in
Example output
{
  "document": {
    "folder_id": "6511f0bb9c1e4b0012ab34ce",
    "id": "6511f0cc9c1e4b0012ab34cf",
    "name": "Audited accounts 2025.pdf",
    "size_bytes": 482133,
    "type": "DOCUMENT"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}

On this page