Synupv1
Criar chave
v1Recursos/Media/patchAtualizar um asset

Atualizar um asset

Atualiza os metadados de sobreposição de um asset — tags, associação a pastas, locais atribuídos — e, apenas para uploads, seu título. Origens sincronizadas/geradas ignoram o título; ali ele é somente leitura.

patch/api/v1/media/{id}
media:write
Parâmetros de consulta
idstringobrigatório
O asset a atualizar.
Corpo da solicitação
titlestringopcional
Novo título. Somente uploads; ignorado para outras origens.
tagsarray of stringopcional
Substitui a lista completa de tags do asset, por nome.
folderIdsarray of stringopcional
Substitui a associação a pastas do asset.
locationIdsarray of stringopcional
Substitui os locais atribuídos ao asset.
statusstring (ok | needs_review | spam)opcional
Define manualmente o veredito de moderação. Somente mídia sincronizada.
statusReasonstringopcional
Nota opcional explicando o status, exibida ao lado dele.
Resposta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador composto do arquivo, no formato "<source>:<id>".
sourcestringopcional
Origem deste arquivo (ex.: um envio do OS em vez de uma fonte importada).
idstringopcional
O id do arquivo dentro de sua fonte.
titlestringopcional
O título do arquivo.
filenamestringopcional
O nome de arquivo original do arquivo.
mimestringopcional
O tipo MIME do arquivo.
kindstringopcional
O tipo do arquivo (foto ou vídeo).
sizeBytesnumberopcional
Tamanho do arquivo em bytes, ou null se desconhecido.
urlstringopcional
URL pronta para uso com os bytes do arquivo.
thumbnailUrlstringopcional
URL de uma miniatura de pré-visualização, ou null.
tagsarray of stringopcional
Tags associadas ao arquivo.
folderIdsarray of stringopcional
Pastas de arquivos às quais este arquivo pertence.
locationIdsarray of stringopcional
Todos os locais associados a este arquivo.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
patch/api/v1/media/{id}
Sua chave de API
id *
Corpo da solicitação
{
  "data": {
    "asset": {
      "key": "upload:abc123",
      "source": "upload",
      "id": "abc123",
      "title": "Storefront photo",
      "filename": "storefront.jpg",
      "mime": "image/jpeg",
      "kind": "image",
      "sizeBytes": 482913,
      "url": "https://cdn.synup.com/media/abc123.jpg",
      "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
      "tags": [
        "VIP"
      ],
      "folderIds": [
        "folder_1"
      ],
      "locationIds": [
        "loc_456"
      ]
    }
  }
}