# Filestage API Documentation

This is the complete API documentation for connecting to the Filestage API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Filestage connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/filestage/actions/{actionSlug}/run
```

## Filestage actions

- POST `add-collaborators-to-project` Add Collaborators to Project
- POST `add-new-section` Add New Section
- POST `add-new-webhook` Add New Webhook
- POST `add-reviewer-group-to-project` Add Reviewer Group to Project
- POST `add-reviewer-group-to-project-template` Add Reviewer Group to Project Template
- POST `add-reviewers-to-reviewer-group` Add Reviewers to Reviewer Group
- POST `add-section-to-project-template` Add Section to Project Template
- POST `approve-a-version` Approve a Version
- POST `approve-a-version-with-changes` Approve a Version With Changes
- PUT `archive-or-unarchive-project-by-id` Archive or Unarchive Project by ID
- POST `copy-comments-between-versions-or-reviews` Copy Comments Between Versions or Reviews
- POST `create-comment-reply` Create Comment Reply
- POST `create-folder` Create Folder
- POST `create-new-project-template` Create New Project Template
- POST `create-project` Create Project
- POST `create-review-comment` Create Review Comment
- GET `download-comment-attachment` Download Comment Attachment
- GET `download-file-version` Download File Version
- GET `download-review-report-of-file` Download Review Report of File
- GET `download-review-report-of-review` Download Review Report of Review
- POST `generate-presigned-upload-url` Generate Presigned Upload URL
- GET `get-comment` Get Comment
- GET `get-file-by-id` Get File by ID
- GET `get-file-url` Get File URL
- GET `get-folder-by-id` Get Folder by ID
- GET `get-project-by-id` Get Project by ID
- GET `get-review-by-id` Get Review by ID
- GET `get-review-decision-count` Get Review Decision Count
- GET `get-reviewer-group-by-id` Get Reviewer Group by ID
- POST `import-website` Import Website
- POST `invite-team-member` Invite Team Member
- POST `invite-team-members` Invite Team Members
- GET `list-comments-by-review` List Comments by Review
- GET `list-file-reviews` List File Reviews
- GET `list-file-reviews-by-parameters` List File Reviews by Parameters
- GET `list-files-by-parameters` List Files by Parameters
- GET `list-files-by-project` List Files by Project
- GET `list-files-in-section` List Files in Section
- GET `list-folders` List Folders
- GET `list-mention-suggestions` List Mention Suggestions
- GET `list-project-templates` List Project Templates
- GET `list-projects` List Projects
- GET `list-reviewer-groups-by-project` List Reviewer Groups by Project
- GET `list-reviews-for-a-reviewer-group` List Reviews for a Reviewer Group
- GET `list-team-members` List Team Members
- GET `list-team-roles` List Team Roles
- GET `list-webhooks` List Webhooks
- PUT `move-file-to-a-section` Move File to a Section
- PUT `move-project-to-a-folder` Move Project to a Folder
- PUT `move-section` Move Section
- PUT `pin-or-unpin-a-comment` Pin or Unpin a Comment
- POST `reject-a-version` Reject a Version
- DELETE `remove-collaborator` Remove Collaborator
- DELETE `remove-comment` Remove Comment
- DELETE `remove-file` Remove File
- DELETE `remove-file-by-external-id` Remove File by External ID
- DELETE `remove-project-by-id` Remove Project by ID
- DELETE `remove-project-template` Remove Project Template
- DELETE `remove-reviewer-group` Remove Reviewer Group
- DELETE `remove-reviewers-from-reviewer-group` Remove Reviewers from Reviewer Group
- DELETE `remove-section` Remove Section
- DELETE `remove-team-member-by-email-or-idp-id` Remove Team Member by Email or IdP ID
- DELETE `remove-team-member-by-member-id` Remove Team Member by Member ID
- DELETE `remove-webhook-by-id` Remove Webhook by ID
- PUT `rename-project-by-id` Rename Project by ID
- PUT `rename-project-template` Rename Project Template
- PUT `rename-reviewer-group` Rename Reviewer Group
- PUT `rename-section` Rename Section
- POST `request-changes` Request Changes
- PUT `set-review-due-date` Set Review Due Date
- POST `start-a-review` Start a Review
- POST `submit-a-review-decision` Submit a Review Decision
- DELETE `undo-review-decision` Undo Review Decision
- PUT `update-comment` Update Comment
- PUT `update-comment-resolution` Update Comment Resolution
- PUT `update-review-status` Update Review Status
- PUT `update-reviewer-group-settings` Update Reviewer Group Settings
- PUT `update-role-of-team-member` Update Role of Team Member
- PUT `update-team-member` Update Team Member
- PUT `update-webhook-by-id` Update Webhook by ID
- POST `upload-file` Upload File