Synupv1
Criar chave
v1Recursos/Dados/postCriar uma pasta

Criar uma pasta

Cria uma nova pasta vazia. Adicione assets a ela com POST /api/v1/folders/{id}/items.

post/api/v1/folders
media:write
Corpo da solicitação
namestringobrigatório
O nome da pasta. Obrigatório.
descriptionstringopcional
Uma descrição opcional.
scopeTypestring (account | client | location | brand)opcional
Escopo opcional: account, client, location ou brand. Pastas sem escopo valem para toda a agência.
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.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/folders
Sua chave de API
Corpo da solicitação*
{
  "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"
    }
  }
}