Import a file from a URL

Regionalus.api.brault.app— follows the region selector in the top bar

Downloads a public http(s) URL into the brandspace. Asynchronous: poll /v1/imports/{import_id}. Maximum 5 GiB, 2 concurrent imports per brandspace.

Authorization

apiKey

AuthorizationBearer <token>

API key from Settings → Developers

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*string

Public http(s) URL of the file to import.

Lengthlength <= 2048

name?string

Name for the imported file. Defaults to the source filename.

library_id?string

Library to import into. Exactly one of library_id, folder_id.

folder_id?string

Folder to import into. Exactly one of library_id, folder_id.

Response Body

`application/json`

curl -X POST "https://example.com/v1/files/import" \  -H "Content-Type: application/json" \  -d '{    "url": "string"  }'

{  "object": "import",  "id": "string",  "status": "queued",  "source_url": "string",  "file_id": "string",  "bytes_total": 0,  "bytes_written": 0,  "error_code": "string",  "created_at": "2019-08-24T14:15:22Z",  "finished_at": "2019-08-24T14:15:22Z"}

Authorization

Request Body

Response Body

202application/json

defaultapplication/json

`application/json`

`application/json`