Synupv1
Crear clave
v1Recursos/Datos/patchActualizar una carpeta

Actualizar una carpeta

Renombra una carpeta o edita su descripción o alcance.

patch/api/v1/folders/{id}
media:write
Parámetros de consulta
idstringobligatorio
La carpeta a actualizar.
Cuerpo de la solicitud
namestringopcional
Nuevo nombre.
descriptionstringopcional
Nueva descripción, o null para borrarla.
scopeTypestring (account | client | location | brand)opcional
Nuevo tipo de alcance: account, client, location o brand.
scopeIdstringopcional
El id para scopeType, si se indica.
Respuesta
dataobjectopcional
folderobjectopcional
idstringopcional
Identificador único de la carpeta.
namestringopcional
El nombre de la carpeta.
descriptionstringopcional
La descripción de la carpeta, o null.
itemCountnumberopcional
Cantidad de assets actualmente en la carpeta.
sourceMixarray of stringopcional
Las fuentes de assets distintas presentes en la carpeta.
scopeobjectopcional
El alcance de la carpeta, o null cuando es de toda la agencia.
typestring (account | client | location | brand)opcional
idstringopcional
sharingobjectopcional
El estado de uso compartido público de la carpeta.
accessstring (restricted | link)opcional
urlstringopcional
createdAtstringopcional
Cuándo se creó la carpeta, como marca de tiempo ISO 8601.
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/folders/{id}
Su clave de API
id *
Cuerpo de la solicitud
{
  "data": {
    "folder": {
      "id": "folder_1",
      "name": "Storefront Photos (2026)",
      "description": "Current-season storefront shots",
      "itemCount": 12,
      "sourceMix": [
        "upload",
        "gmb"
      ],
      "scope": {
        "type": "client",
        "id": "cli_123"
      },
      "sharing": {
        "access": "restricted",
        "url": null
      },
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  }
}