---
title: File API
description: Interface paths, methods, parameters, and return fields for the File API.
slug: developer-api-files
lang: en
category: File API
category_order: 8
order: 3
hide_in_nav: true
keywords:
  - API
  - File API
  - Developer
---


# File APIs

List and manage files, folders, versions, transfers, recycle-bin items and material libraries. Upload requires pre-upload followed by binary transfer. Confirm targets before deletion or replacement.

## Endpoints

| Method | Endpoint | Path |
| --- | --- | --- |
| `GET` | [Get download address of multiple files](api-get-api-file-downloadmultifiles-do.md) | `/api/file/downloadMultiFiles.do` |
| `GET` | [Get download file thumbnail address](api-get-api-file-downloadthumbnail-do.md) | `/api/file/downloadThumbnail.do` |
| `GET` | [Get download file address](api-get-api-file-getfiledownloadurl-do.md) | `/api/file/getFileDownloadUrl.do` |
| `GET` | [Pre-upload files](api-get-api-file-preuploadfile-do.md) | `/api/file/preUploadFile.do` |
| `GET` | [file log](api-get-nd-api-file-file-logs.md) | `/nd/api/file/file_logs` |
| `GET` | [Get file information](api-get-nd-api-file-fileinfo.md) | `/nd/api/file/fileinfo` |
| `GET` | [Get file list](api-get-nd-api-file-list-dir.md) | `/nd/api/file/list_dir` |
| `GET` | [Get all version information of a file](api-get-nd-api-file-versions.md) | `/nd/api/file/versions` |
| `POST` | [Copy file progress](api-post-nd-api-file-copy-progress.md) | `/nd/api/file/copy_progress` |
| `POST` | [Copy files](api-post-nd-api-file-copy.md) | `/nd/api/file/copy` |
| `POST` | [Create folder](api-post-nd-api-file-create-folder.md) | `/nd/api/file/create_folder` |
| `POST` | [Create library categories](api-post-nd-api-file-create-material-class.md) | `/nd/api/file/create_material_class` |
| `POST` | [Create sub-library](api-post-nd-api-file-create-material-folder.md) | `/nd/api/file/create_material_folder` |
| `POST` | [Empty Recycle Bin](api-post-nd-api-file-empty-trash.md) | `/nd/api/file/empty_trash` |
| `POST` | [Move files](api-post-nd-api-file-move.md) | `/nd/api/file/move` |
| `POST` | [Delete files (to recycle bin)](api-post-nd-api-file-remove-file.md) | `/nd/api/file/remove_file` |
| `POST` | [Delete files (from Recycle Bin)](api-post-nd-api-file-remove-from-trash.md) | `/nd/api/file/remove_from_trash` |
| `POST` | [Modify file name](api-post-nd-api-file-rename.md) | `/nd/api/file/rename` |
| `POST` | [Recover files (from Recycle Bin)](api-post-nd-api-file-restore-file.md) | `/nd/api/file/restore_file` |
| `POST` | [Set whether the user has access to the material library](api-post-nd-api-file-set-user-access-material-library.md) | `/nd/api/file/set_user_access_material_library` |
| `POST` | [Modify file information](api-post-nd-api-file-update-file.md) | `/nd/api/file/update_file` |
| `POST` | [Set the current version of the file](api-post-nd-api-file-version.md) | `/nd/api/file/version` |

## Completing an Upload

Call [pre-upload](api-get-api-file-preuploadfile-do.md), then POST `multipart/form-data` to its returned `url` with binary `file` and `upload_token`. Verify `success`, `code`, `fileId` and `version`. Never hard-code the upload URL; obtain another when used or expired.

## Integration Notes

Based on the supplied Babel API reference. Preserve exact endpoint paths and field casing. Confirm unspecified or inconsistent field types during integration rather than assuming undocumented parameters. Use the deployment's HTTPS domain and keep credentials out of public pages.

[API overview](developer-api-overview.md) · [MCP quick start](mcp-integration.md)