Synupv1
Crear clave
v1Recursos/Datos/postCrear una carpeta

Crear una carpeta

Crea una carpeta nueva y vacía. Agréguele assets con POST /api/v1/folders/{id}/items.

post/api/v1/folders
media:write
Cuerpo de la solicitud
namestringobligatorio
El nombre de la carpeta. Obligatorio.
descriptionstringopcional
Una descripción opcional.
scopeTypestring (account | client | location | brand)opcional
Alcance opcional: account, client, location o brand. Las carpetas sin alcance son de toda la agencia.
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/folders
Su clave de API
Cuerpo de la solicitud*
{
  "data": {
    "folder": {
      "id": "folder_1",
      "name": "Storefront Photos",
      "description": null,
      "itemCount": 0,
      "sourceMix": [],
      "scope": null,
      "sharing": {
        "access": "restricted",
        "url": null
      },
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  }
}