position. Uma foto por chamada, corpo multipart/form-data com a parte file e, opcionalmente, alt e position. Para um imóvel com muitas fotos, cadastre o imóvel sem foto e envie as fotos em paralelo, até 6 por vez por conta: cada uma entra na chegada, sem id para guardar nem segunda chamada. A ordem final pode ser ajustada depois em PATCH /v1/properties/{ref} (media.images), que também troca a capa.POST /v1/media com purpose=property seguido do vínculo. Dispara property.updated.201: foto anexada; data é a foto como aparece em media.images[].400: arquivo ausente, tipo não aceito, foto fora das dimensões ou campo inválido.404 PROPERTY_NOT_FOUND: inexistente, na lixeira, de outra conta ou fora do recorte da chave.413 FILE_TOO_LARGE: arquivo acima de 15 MB.429 UPLOAD_CONCURRENCY_EXCEEDED: a conta já tem 6 uploads em andamento; nada foi lido. Reenvie após o Retry-After.503: o armazenamento ou o otimizador de imagem não respondeu, ou há uploads demais em andamento na plataforma (UPLOAD_BUSY); nada foi gravado. Retry-After diz quando tentar de novo.Idempotency-Key: reenviar o mesmo arquivo anexa outra foto.curl --location 'https://api.veploy.com/v1/properties//images' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'alt=""' \
--form 'position=""'{
"data": {
"id": "string",
"url": "string",
"featured": true,
"alt": null,
"position": 0
}
}