Esta API organiza a visão de quem faz a chamada. As pastas e os favoritos de um workspace são
individuais: cada membro pode escolher a própria organização, sem alterar a visão dos outros membros.
Escopo e leitura
Use um token Bearer e o ID do workspace no caminho. A organização do membro é retornada em
GET /v1/workspaces/:id, no campo
response.resource_organization.
Uma chave de API precisa de workspaces:read para ler o workspace e de workspaces:write para
alterar a organização desse workspace.
Pastas e favoritos aceitam application, database, image e stack. As cores das pastas são
neutral, red, orange, yellow, green, blue e purple.
Criar uma pasta
name é obrigatório. color, position, notes (texto livre; null remove na atualização) e
flow_layout ({ "x": 0, "y": 0, "collapsed": false }, a posição dela no canvas do Flow; null
remove na atualização) são opcionais. A resposta contém a pasta criada em response.
Renomear, mudar a cor ou reordenar uma pasta
Envie apenas os campos que quer alterar. A resposta contém a pasta atualizada em response.
Apagar uma pasta
Apagar remove a organização da pasta, mas não apaga nem desvincula a aplicação ou o banco de dados.
Colocar ou remover um recurso em uma pasta
Use resource_type=application, database, image ou stack. resource_id identifica o recurso
ao qual o membro tem acesso. O corpo pode conter a posição dentro da pasta:
Para remover apenas o vínculo:
Colocar o mesmo recurso em outra pasta o move dentro da organização desse membro. A resposta das duas
operações retorna a organização atualizada em response.
Favoritar e desfavoritar um recurso
Para desfavoritar:
Favorito e pasta são independentes, e as operações retornam a organização atualizada em response.
Podem ser repetidas com segurança.
Atividade
Criar, editar ou apagar uma pasta, mover um recurso, e favoritar ou desfavoritar geram uma atividade.
Isso vale para ações no painel e em workflows, e também para chamadas com chave de API feitas pela CLI,
pelo MCP ou pela extensão. O cliente não envia origin nem author_id; a API define esses campos.
Estas pastas não são grupos do Flow. Grupos organizam elementos no canvas local do Flow; eles não têm
um group_id compartilhado com esta API e não são sincronizados nem migrados para pastas. Última modificação em 28 de outubro de 2026
