# Datasite

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/datasite

## Actions

### Activate or deactivate user

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

**Inputs**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Person (`participant_id`, text, required): Pick someone in the project, or give their user ID from an earlier step.
- Access (`access`, text, required): Activate or deactivate their access. One of: `ACTIVATED` (Activate), `DEACTIVATED` (Deactivate).

**Outputs**

- `participant` (object): The person
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Question (`question`, text, required): What to ask.
- Category (`category_id`, text): The question's category. Leave empty for none.
- Priority (`priority`, true/false): Turn on to mark it as a priority question. Default: `false`.
- About documents (`document_ids`, text): IDs of documents the question is about, separated by commas. Leave empty for none.

**Outputs**

- `project_id` (text): The project it is in
- `question` (object): The question

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Question (`question_id`, text, required): Pick a question, or give its ID from a trigger or an earlier step.
- Closed (`closed`, true/false): On closes the question; off reopens it. Default: `true`.

**Outputs**

- `project_id` (text): The project it is in
- `question` (object): The question

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Fileroom name (`name`, text, required): The fileroom's name.
- Publish (`published`, true/false): Turn on to publish it now, so people with access can see it. Off keeps it unpublished. Default: `false`.

**Outputs**

- `fileroom` (object): The new fileroom
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Put it in (`parent_id`, text, required): The fileroom or folder to create it in. Pick one, or give its ID from an earlier step.
- Folder name (`name`, text, required): The folder's name.
- Publish (`published`, true/false): Turn on to publish it now, so people with access can see it. Off keeps it unpublished. Default: `false`.
- Hide from everyone (`hidden`, true/false): Turn on to hide it from every role. Off gives it the permissions of the folder it is in. Default: `false`.

**Outputs**

- `folder` (object): The new folder
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Document or folder (`item_id`, text, required): Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `item_id` (text): What was deleted
- `project_id` (text): The project it is in

**Example output**

```json
{
  "deleted": true,
  "item_id": "6511f0cc9c1e4b0012ab34cf",
  "project_id": "5f6bae25cacf456aacc4c535"
}
```

### Delete question

Delete a Q&A question, saying why.

**Inputs**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Question (`question_id`, text, required): Pick a question, or give its ID from a trigger or an earlier step.
- Reason (`reason`, text, required): Why it is being deleted. One of: `DUPLICATE`, `INACCURATE`, `CONFIDENTIAL_DISCLOSURE` (Confidential disclosure), `TEST_QUESTION` (Test question), `TEAM_INSTRUCTION` (Team instruction), `OTHER`.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `project_id` (text): The project it is in
- `question_id` (text): The question deleted

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Document or folder (`item_id`, text, required): Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.

**Outputs**

- `item` (object): The document or folder
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Question (`question_id`, text, required): Pick a question, or give its ID from a trigger or an earlier step.
- Mark as read (`mark_as_read`, true/false): Turn on to mark it read for the connected person. Off leaves it as it is. Default: `false`.

**Outputs**

- `project_id` (text): The project it is in
- `question` (object): The question

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Email (`email`, text, required): The email address to invite.
- Role (`role_id`, text, required): The role to give them. Pick one, or give its ID from an earlier step.
- Invitation language (`language`, text): 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 deal (`side`, text): 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**

- `email` (text): The address invited
- `project_id` (text): The project it is in
- `role_id` (text): The role they were given
- `user_id` (text): Their Datasite user ID

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.

**Outputs**

- `count` (number): How many are in this answer
- `filerooms` (list): The filerooms
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Fileroom or folder (`folder_id`, text, required): Pick one, or give its ID from an earlier step.
- Show only (`item_type`, text): Only list documents, folders or placeholders. Leave empty for all. One of: `DOCUMENT` (Documents), `FOLDER` (Folders), `PLACEHOLDER` (Placeholders).

**Outputs**

- `count` (number): How many are in this answer
- `folder_id` (text): The fileroom or folder listed
- `items` (list): What is in it
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Status (`status`, text): Only people with this status. Leave empty for everyone. One of: `ACTIVATED` (Active), `INVITED`, `DEACTIVATED`, `DRAFTED`, `EXPIRED`.
- Role (`role_id`, text): Only people with this role. Leave empty for every role.

**Outputs**

- `count` (number): How many are in this answer
- `participants` (list): The people
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

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

**Outputs**

- `count` (number): How many are in this answer
- `projects` (list): The projects

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Open or closed (`state`, text): Only open or only closed questions. Leave empty for both. One of: `open`, `closed`.

**Outputs**

- `count` (number): How many are in this answer
- `project_id` (text): The project it is in
- `questions` (list): The questions

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.

**Outputs**

- `count` (number): How many are in this answer
- `project_id` (text): The project it is in
- `roles` (list): The roles

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Search for (`query`, text, required): The words to look for.
- Added after (`added_after`, date and time): Only documents added after this. Leave empty for any time.
- Added before (`added_before`, date and time): Only documents added before this. Leave empty for any time.
- Most results (`limit`, number): How many documents to return at most, up to 1000. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many are in this answer
- `documents` (list): The documents found
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Document or folder (`item_id`, text, required): Pick a fileroom or folder, or give a document's or folder's ID from a trigger or an earlier step.
- New name (`name`, text): Its new name. Leave empty to keep it.
- Publishing (`publishing`, text): Publish or unpublish it. Leave empty to keep it as it is. One of: `PUBLISHED` (Publish), `UNPUBLISHED` (Unpublish).

**Outputs**

- `item` (object): The document or folder
- `project_id` (text): The project it is in

**Example output**

```json
{
  "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**

- Project (`project_id`, text, required): The Datasite project (data room). Pick one, or give its ID from an earlier step.
- Fileroom or folder (`folder_id`, text, required): Where to put it. Pick one, or give its ID from an earlier step.
- File (`file`, text, required): The file: upload one, pick one an earlier step made, or paste a public link to one.
- File name (`name`, text): The document's name in Datasite, with its extension. Leave empty to use the file's own name.
- Publish (`published`, true/false): Turn on to publish it now, so people with access can see it. Off keeps it unpublished. Default: `false`.
- Hide from everyone (`hidden`, true/false): Turn on to hide it from every role. Off gives it the permissions of the folder it is in. Default: `false`.

**Outputs**

- `document` (object): The new document
- `project_id` (text): The project it is in

**Example output**

```json
{
  "document": {
    "folder_id": "6511f0bb9c1e4b0012ab34ce",
    "id": "6511f0cc9c1e4b0012ab34cf",
    "name": "Audited accounts 2025.pdf",
    "size_bytes": 482133,
    "type": "DOCUMENT"
  },
  "project_id": "5f6bae25cacf456aacc4c535"
}
```
