Skip to main content

People

Customers and suppliers — the counterparty of any bill. ids returns identifiers only, handy to keep an agent's context window small.

CommandHTTPDescription
people listGET /v1/peopleList people (customers / suppliers)
people createPOST /v1/peopleCreate a person (customer / supplier)
people getGET /v1/people/{id}Get a person by ID
people updatePATCH /v1/people/{id}Update a person
people deleteDELETE /v1/people/{id}Delete a person
people ids listGET /v1/people/idsList person IDs

Examples​

--params carries query and path parameters (id, page, filters); --json carries the request body; --fields limits which fields come back — worth using on every list/get to save context. See Global flags for the full reference.

# List people (customers / suppliers)
kobana finance people list --fields "id,company_id,name,legal_name,nickname"

# Get a person by ID
kobana finance people get --params '{"id": "PEOPLE_ID"}'

# Create a person (customer / supplier)
kobana finance people create \
--json '{"company_id": "COMPANY_ID", "name": "NAME"}'

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

# Delete a person
kobana finance people delete --params '{"id": "PEOPLE_ID"}' --dry-run

Next steps​