# Create multiple files `POST /api/v1/files` Registers multiple already-uploaded files in a single folder. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Files → Write**. ## Body parameters - `parent_id` (integer or null) — ID of the parent folder. Use null for the root. Alias folder_id on creation. - `files_data` (array of objects, required) — Each file needs a name and URL. A file can include uploadcare_response with optional upload metadata such as size and mimeType. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/files" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "Content-Type: application/json" \ --data '{"parent_id":20,"files_data":[{"name":"welcome.pdf","url":"https://files.example.com/welcome.pdf"},{"name":"schedule.pdf","url":"https://files.example.com/schedule.pdf"}]}' ``` ## Response **201 Created** Returns the created files in `data` and the number created. Example with fictional data and selected fields. ```json { "status": "success", "message_key": "entities.file.messages.created_multiple", "vars": { "count": 2 }, "count": 2, "data": [ { "id": 16, "name": "welcome.pdf", "url": "https://files.example.com/welcome.pdf", "parent_id": 20, "is_folder": false }, { "id": 17, "name": "schedule.pdf", "url": "https://files.example.com/schedule.pdf", "parent_id": 20, "is_folder": false } ] } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `400` — Some files failed. Others may have been created. - `422` — One or more fields failed validation.