Synupv1
Crear clave
v1Recursos/Media/patchActualizar un asset

Actualizar un asset

Actualiza los metadatos de superposición de un asset — etiquetas, pertenencia a carpetas, ubicaciones asignadas — y, solo para subidas, su título. Las fuentes sincronizadas o generadas ignoran el título; ahí es de solo lectura.

patch/api/v1/media/{id}
media:write
Parámetros de consulta
idstringobligatorio
El asset a actualizar.
Cuerpo de la solicitud
titlestringopcional
Nuevo título. Solo subidas; se ignora en otras fuentes.
tagsarray of stringopcional
Reemplaza la lista completa de etiquetas del asset, por nombre.
folderIdsarray of stringopcional
Reemplaza la pertenencia a carpetas del asset.
locationIdsarray of stringopcional
Reemplaza las ubicaciones asignadas del asset.
statusstring (ok | needs_review | spam)opcional
Establece manualmente el veredicto de moderación. Solo medios sincronizados.
statusReasonstringopcional
Nota opcional que explica el estado, mostrada junto a él.
Respuesta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador compuesto del archivo, con el formato "<source>:<id>".
sourcestringopcional
Origen de este archivo (p. ej. una subida de OS frente a una fuente importada).
idstringopcional
El id del archivo dentro de su fuente.
titlestringopcional
El título del archivo.
filenamestringopcional
El nombre de archivo original del archivo.
mimestringopcional
El tipo MIME del archivo.
kindstringopcional
El tipo del archivo (foto o video).
sizeBytesnumberopcional
Tamaño del archivo en bytes, o null si se desconoce.
urlstringopcional
URL lista para usar con los bytes del archivo.
thumbnailUrlstringopcional
URL de una vista previa en miniatura, o null.
tagsarray of stringopcional
Etiquetas asociadas al archivo.
folderIdsarray of stringopcional
Carpetas de archivos a las que pertenece este archivo.
locationIdsarray of stringopcional
Todas las ubicaciones con las que está asociado este archivo.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
patch/api/v1/media/{id}
Su clave de API
id *
Cuerpo de la solicitud
{
  "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"
      ]
    }
  }
}