SIsignalshq
CLIENT
Client Document Management
DMS Documents

Bulk move documents

Move multiple documents to a different folder

post/internal/api/clients/{client_id}/dms/documents/bulk-move

Request

  • Base URL
    https://api.signalshq.io (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Path parameters

client_idstring uuid required

Client ID

Request body

folder_idsstring[] nullable

List of folder IDs to move

document_idsstring[] nullable

List of document IDs to move

target_folder_idstring uuid nullable required

Target folder ID (null for root folder)

reasonstring required

Reason for moving folders/documents

auto_rename_on_conflictboolean

Auto-rename folders/documents if name conflicts in target folder (e.g., folder(1), file(1).pdf). Default is True.

Response

Successful Response

success_countinteger required

Number of successful operations

failure_countinteger required

Number of failed operations

total_countinteger required

Total number of operations attempted

renamed_documentsobject nullable

Documents that were auto-renamed due to conflicts. Key: document_id (str), Value: RenamedDocumentInfo

renamed_foldersobject nullable

Folders that were auto-renamed due to conflicts. Key: folder_id (str), Value: RenamedDocumentInfo

warningsstring[]

Non-fatal warnings surfaced to the CPA. For move operations: populated when any moved item lands inside a shared folder, meaning the client immediately gains access to those items.

Example response

{
  "details": {
    "documents_deleted": 13,
    "documents_failed": 1,
    "folders_deleted": 5,
    "folders_failed": 2
  },
  "errors": [
    {
      "entity_id": "123e4567-e89b-12d3-a456-426614174000",
      "entity_name": "Tax Documents 2024",
      "entity_type": "folder",
      "error": "Folder is not empty. Use cascade_delete=true to delete contents."
    },
    {
      "entity_id": "987fcdeb-51a2-43f7-b890-123456789abc",
      "entity_name": "W2_Form.pdf",
      "entity_type": "document",
      "error": "Document is locked and cannot be deleted."
    }
  ],
  "failure_count": 3,
  "success_count": 18,
  "total_count": 21
}

Changes

No recorded changes to this operation across all 1 revision of this API.