Skip to main content
POST
https://localapi.lazydata.com.br
/
v1
/
storage
/
uploads
Preparar upload
curl --request POST \
  --url https://localapi.lazydata.com.br/v1/storage/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parent_id": "<string>"
}
'
{
  "code": 200,
  "message": "Assinatura de upload gerada.",
  "result": {
    "upload_url": "https://upload.lazydata.com.br/storage",
    "signature": "<assinatura_de_upload>",
    "signature_expires_at": "2026-06-22T14:00:00+00:00",
    "max_size": 1073741824,
    "file": {
      "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
      "type": "file",
      "name": "contrato.pdf",
      "parent_id": null,
      "extension": "pdf",
      "content_type": null,
      "size": 0,
      "status": "waiting_upload",
      "uploaded_at": null,
      "created_at": "2026-06-22T11:59:40+00:00",
      "updated_at": "2026-06-22T11:59:40+00:00"
    }
  }
}
Cria o registro inicial do arquivo e retorna uma assinatura temporária para envio ao serviço de upload. Depois desta chamada, envie o arquivo para upload_url usando o header X-LazyData-Upload-Signature. 
{
  "code": 200,
  "message": "Assinatura de upload gerada.",
  "result": {
    "upload_url": "https://upload.lazydata.com.br/storage",
    "signature": "<assinatura_de_upload>",
    "signature_expires_at": "2026-06-22T14:00:00+00:00",
    "max_size": 1073741824,
    "file": {
      "id": "9fcb573b-7f62-4774-978b-07e89dfef5f2",
      "type": "file",
      "name": "contrato.pdf",
      "parent_id": null,
      "extension": "pdf",
      "content_type": null,
      "size": 0,
      "status": "waiting_upload",
      "uploaded_at": null,
      "created_at": "2026-06-22T11:59:40+00:00",
      "updated_at": "2026-06-22T11:59:40+00:00"
    }
  }
}

​
Corpo da requisição

​
name
string
required
Nome do arquivo que será enviado.
​
parent_id
string
ID da pasta de destino. Use null para enviar para a raiz.

​
Exemplo de corpo

{
  "name": "contrato.pdf",
  "parent_id": null
}

​
Resposta

CampoTipoDescrição
upload_urlstringURL do serviço de upload.
signaturestringAssinatura temporária usada no header de upload.
signature_expires_atstringData de expiração da assinatura.
max_sizeintegerTamanho máximo permitido em bytes.
fileobjectRegistro inicial do arquivo.

​
Próximo passo

Enviar arquivo

Envie o arquivo para https://upload.lazydata.com.br/storage usando a assinatura retornada.