Archivos
La biblioteca de archivos del workspace — imágenes, PDF y documentos que muestra el portal, públicos o restringidos a un titular. download devuelve el contenido; presign create genera una URL de envío directo al storage para archivos por encima del límite de 2 MB del cuerpo de la solicitud.
| Comando | HTTP | Descripción |
|---|---|---|
assets list | GET /v1/assets | Listar archivos |
assets create | POST /v1/assets | Agregar archivo |
assets get | GET /v1/assets/{id} | Consultar archivo |
assets update | PATCH /v1/assets/{id} | Actualizar archivo |
assets delete | DELETE /v1/assets/{id} | Eliminar archivo |
assets download | GET /v1/assets/{id}/download | Descargar archivo |
assets presign create | POST /v1/assets/presign | Generar URL de envío |
Ejemplos
--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.
# Listar archivos
kobana dashboards assets list \
--params '{"tenant_id": "TENANT_ID"}' \
--fields "id,name,kind,visibility,size_bytes"
# Agregar archivo
kobana dashboards assets create \
--json '{"name": "contrato.pdf", "content_base64": "JVBERi0xLjQK...", "content_type": "application/pdf", "visibility": "restricted", "tenant_id": "TENANT_ID"}'
# Descargar archivo
kobana dashboards assets download \
--params '{"id": "ASSET_ID"}' \
--output contrato.pdf
# Generar URL de envío
kobana dashboards assets presign create \
--json '{"filename": "video.mp4", "content_type": "video/mp4", "size": 52428800}'
Próximos pasos
- Tipos de archivo
- Introspección de schema — todos los parámetros que acepta este recurso.