Synupv1
Criar chave
v1Recursos/Dados/patchAtualizar uma pasta

Atualizar uma pasta

Renomeia uma pasta ou edita sua descrição ou escopo.

patch/api/v1/folders/{id}
media:write
Parâmetros de consulta
idstringobrigatório
A pasta a atualizar.
Corpo da solicitação
namestringopcional
Novo nome.
descriptionstringopcional
Nova descrição, ou null para removê-la.
scopeTypestring (account | client | location | brand)opcional
Novo tipo de escopo: account, client, location ou brand.
scopeIdstringopcional
O id para scopeType, se informado.
Resposta
dataobjectopcional
folderobjectopcional
idstringopcional
Identificador único da pasta.
namestringopcional
O nome da pasta.
descriptionstringopcional
A descrição da pasta, ou null.
itemCountnumberopcional
Número de assets atualmente na pasta.
sourceMixarray of stringopcional
As origens de assets distintas presentes na pasta.
scopeobjectopcional
O escopo da pasta, ou null quando vale para toda a agência.
typestring (account | client | location | brand)opcional
idstringopcional
sharingobjectopcional
O estado de compartilhamento público da pasta.
accessstring (restricted | link)opcional
urlstringopcional
createdAtstringopcional
Quando a pasta foi criada, como timestamp ISO 8601.
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/folders/{id}
Sua chave de API
id *
Corpo da solicitação
{
  "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"
    }
  }
}