Anexos
Arquivos — nota, contrato, comprovante — enviados ao acervo e ligados a um ou mais títulos. links é o que cria e desfaz esse vínculo.
| Comando | HTTP | Descrição |
|---|---|---|
attachments list | GET /v1/attachments | Listar anexos |
attachments create | POST /v1/attachments | Enviar um anexo |
attachments get | GET /v1/attachments/{id} | Obter metadados do anexo por ID |
attachments delete | DELETE /v1/attachments/{id} | Excluir anexo |
attachments download | GET /v1/attachments/{id}/download | Baixar bytes do anexo |
attachments links create | POST /v1/attachments/{id}/links | Vincular anexo a um registro |
attachments links delete | DELETE /v1/attachments/{id}/links | Desvincular anexo de um registro |
Exemplos
--params carrega parâmetros de query e de caminho (id, página, filtros); --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 anexos
kobana finance attachments list \
--fields "id,file_name,title,mime_type,file_size"
# Obter metadados do anexo por ID
kobana finance attachments get --params '{"id": "ATTACHMENT_ID"}'
# Enviar um anexo
kobana finance attachments create
# Excluir anexo
kobana finance attachments delete --params '{"id": "ATTACHMENT_ID"}' --dry-run
Próximos passos
- Comprovantes
- Introspecção de schema — todos os parâmetros que este recurso aceita.