Arquivos
A biblioteca de arquivos do workspace — imagens, PDFs e documentos que o portal mostra, públicos ou restritos a um titular. download devolve o conteúdo; presign create gera uma URL de envio direto ao storage para arquivos acima do limite de 2 MB do corpo da requisição.
| Comando | HTTP | Descrição |
|---|---|---|
assets list | GET /v1/assets | Listar arquivos |
assets create | POST /v1/assets | Adicionar arquivo |
assets get | GET /v1/assets/{id} | Consultar arquivo |
assets update | PATCH /v1/assets/{id} | Atualizar arquivo |
assets delete | DELETE /v1/assets/{id} | Remover arquivo |
assets download | GET /v1/assets/{id}/download | Baixar arquivo |
assets presign create | POST /v1/assets/presign | Gerar URL de envio |
Exemplos
--params carrega parâmetros de query, de caminho e de cabeçalho (id, página, filtros, X-Workspace-Id); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.
# Listar arquivos
kobana dashboards assets list \
--params '{"tenant_id": "TENANT_ID"}' \
--fields "id,name,kind,visibility,size_bytes"
# Adicionar arquivo
kobana dashboards assets create \
--json '{"name": "contrato.pdf", "content_base64": "JVBERi0xLjQK...", "content_type": "application/pdf", "visibility": "restricted", "tenant_id": "TENANT_ID"}'
# Baixar arquivo
kobana dashboards assets download \
--params '{"id": "ASSET_ID"}' \
--output contrato.pdf
# Gerar URL de envio
kobana dashboards assets presign create \
--json '{"filename": "video.mp4", "content_type": "video/mp4", "size": 52428800}'
Próximos passos
- Tipos de arquivo
- Introspecção de schema — todos os parâmetros que este recurso aceita.