Developers
Acessar miCore Começar
Atualizado em 17 de outubro de 2026
SOLUÇÃO

Enviar mídia

Envia uma imagem ou vídeo para a biblioteca de mídia e devolve o `id` e a URL. Esse `id` é o que você usa em outros recursos, como a imagem destacada de um post (`featured_image_id`).

Considerações

  • Exige o escopo media:write e a permissão de criar em Biblioteca de Mídia.
  • O envio é multipart/form-data com o campo file.
  • Aceita imagens e vídeos, até 50 MB no upload direto.
  • As variações de tamanho (thumbnails) são geradas no envio e voltam em derivatives.
  • scope é opcional: vazio entra na biblioteca compartilhada, que aparece no seletor do painel.

Referência

POST /media na Referência da API

Como fazer

Envie o arquivo em multipart/form-data:

cURL
curl -X POST "$MICORE_BASE_URL/media" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -F "file=@banner-outubro.jpg"

Resposta

Em caso de sucesso, a API responde 201 com o item e suas variações:

Resposta · 201
{
  "data": {
    "id": 123,
    "type": "file",
    "mime_type": "image/jpeg",
    "size_bytes": 284910,
    "width": 1600,
    "height": 900,
    "is_image": true,
    "url": "https://cdn.exemplo.com/.../banner-outubro.jpg",
    "derivatives": [
      { "variant": "320w", "width": 320, "url": "https://cdn.exemplo.com/.../123/320w.jpg" },
      { "variant": "640w", "width": 640, "url": "https://cdn.exemplo.com/.../123/640w.jpg" }
    ],
    "created_at": "2026-10-17T09:00:00-03:00"
  }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.