Pessoas

Clientes e fornecedores — a contraparte de qualquer título. ids devolve só os identificadores, útil para não encher a janela de contexto de um agente.

Comando	HTTP	Descrição
people list	GET /v1/people	Listar pessoas (clientes / fornecedores)
people create	POST /v1/people	Criar pessoa (cliente / fornecedor)
people get	GET /v1/people/{id}	Obter pessoa por ID
people update	PATCH /v1/people/{id}	Atualizar pessoa
people delete	DELETE /v1/people/{id}	Excluir pessoa
people ids list	GET /v1/people/ids	Listar IDs de pessoas

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 pessoas (clientes / fornecedores)
kobana finance people list --fields "id,company_id,name,legal_name,nickname"

# Obter pessoa por ID
kobana finance people get --params '{"id": "PEOPLE_ID"}'

# Criar pessoa (cliente / fornecedor)
kobana finance people create \
  --json '{"company_id": "COMPANY_ID", "name": "NAME"}'

# Atualizar pessoa
kobana finance people update \
  --params '{"id": "PEOPLE_ID"}' \
  --json '{"name": "NAME", "legal_name": "LEGAL_NAME", "nickname": "NICKNAME"}'

# Excluir pessoa
kobana finance people delete --params '{"id": "PEOPLE_ID"}' --dry-run

Próximos passos

• Empresas
• Introspecção de schema — todos os parâmetros que este recurso aceita.