Esta API organiza la vista de quien hace la llamada. Las carpetas y los favoritos de un workspace son individuales:
cada miembro puede elegir su propia organización, sin cambiar la vista de los demás miembros.
Alcance y lectura
Usa un token Bearer y el ID del workspace en la ruta. La organización del miembro se devuelve en
GET /v1/workspaces/:id, en el campo
response.resource_organization.
Una clave de API necesita workspaces:read para leer el workspace y workspaces:write para cambiar la
organización de ese workspace.
Las carpetas y los favoritos aceptan application, database, image y stack. Los colores de carpeta son
neutral, red, orange, yellow, green, blue y purple.
Crear una carpeta
name es obligatorio. color, position, notes (texto libre; null lo elimina al actualizar) y flow_layout
({ "x": 0, "y": 0, "collapsed": false }, su lugar en el lienzo de Flow; null lo elimina al actualizar) son
opcionales. La respuesta contiene la carpeta creada en response.
Renombrar, cambiar el color o reordenar una carpeta
Envía solo los campos que quieres cambiar. La respuesta contiene la carpeta actualizada en response.
Eliminar una carpeta
Eliminar quita la organización de la carpeta, pero no elimina ni desvincula la aplicación o la base de datos.
Poner o quitar un recurso en una carpeta
Usa resource_type=application, database, image o stack. resource_id identifica el recurso al que el
miembro puede acceder. El body puede contener la posición dentro de la carpeta:
Para quitar solo el vínculo:
Poner el mismo recurso en otra carpeta lo mueve dentro de la organización de ese miembro. La respuesta de ambas
operaciones devuelve la organización actualizada en response.
Marcar y desmarcar un recurso como favorito
Para desmarcar:
Favorito y carpeta son independientes, y las operaciones devuelven la organización actualizada en response.
Pueden repetirse sin problema.
Actividad
Crear, editar o eliminar una carpeta, mover un recurso, y marcar o desmarcar un favorito genera una actividad. Esto
aplica tanto a las acciones del panel y de los workflows como a las llamadas con clave de API hechas desde la CLI, el
MCP o la extensión. El cliente no envía origin ni author_id; los define la API.
Estas carpetas no son grupos de Flow. Los grupos organizan elementos en el lienzo local de Flow; no tienen un
group_id compartido con esta API y no se sincronizan ni migran a carpetas. Última modificación el 28 de octubre de 2026
