Enviar um arquivo grande

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo file-manager:write e permissão de gravar na pasta de destino.
O início devolve upload_id, key e part_size (10 MB). Corte o arquivo nesse tamanho.
Cada parte vai por PUT para a URL assinada, sem o token; guarde o cabeçalho ETag da resposta.
Ao concluir, envie todas as partes com part_number e etag.
Se algo falhar no meio, chame POST /file-manager/uploads/abort para não deixar partes soltas.

Referência

POST /file-manager/uploads na Referência da API POST /file-manager/uploads/parts na Referência da API POST /file-manager/uploads/complete na Referência da API POST /file-manager/uploads/abort na Referência da API

Como fazer

1. Inicie o envio:

cURL

curl -X POST "$MICORE_BASE_URL/file-manager/uploads" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_id": 497,
    "name": "IMG_9512.MOV",
    "content_type": "video\/quicktime",
    "size": 215912345
}'

2. Para cada parte, peça a URL assinada e envie o trecho do arquivo com PUT:

cURL

curl -X POST "$MICORE_BASE_URL/file-manager/uploads/parts" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "gerenciador-arquivos\/img_9512_20261021.mov",
    "upload_id": "abc123",
    "part_number": 1
}'

curl -X PUT "$URL_ASSINADA" --upload-file parte-1.bin -D -

3. Conclua com a lista de partes e os ETag:

cURL

curl -X POST "$MICORE_BASE_URL/file-manager/uploads/complete" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_id": 497,
    "key": "gerenciador-arquivos\/img_9512_20261021.mov",
    "upload_id": "abc123",
    "original_name": "IMG_9512.MOV",
    "mime_type": "video\/quicktime",
    "size": 215912345,
    "parts": [
        {
            "part_number": 1,
            "etag": "\"9b2cf535f27731c974343645a3985328\""
        }
    ]
}'

Resposta

Ao concluir, a API responde 201 com o arquivo criado na pasta:

cURL

{
  "data": {
    "id": 1444,
    "name": "IMG_9512",
    "type": "file",
    "parent_id": 497,
    "owner_id": 2,
    "visibility": "company",
    "created_at": "2026-10-21T23:48:11-03:00"
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.