Collaboration
Address Book
Counterparties and contacts
Authentication
Authenticate with Authorization: Bearer ak_... — see API keys. Entity-scoped routes use entityId in the query or body; a mismatched entityId returns 403.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/ledger/address-book?entityId= | List counterparties/contacts |
| POST | /api/ledger/address-book | Create contact |
| PUT | /api/ledger/address-book | Update contact |
List counterparties
GET /api/ledger/address-book?entityId={entityId}
Returns counterparties and contacts for the entity. Supports type, search, and other filters.
Create contact
POST /api/ledger/address-book
Body: { "entityId", "name", "type?", "email?", "address?", "bankDetails?", ... }
Update contact
PUT /api/ledger/address-book
Body: { "entityId", "contactId", ...fields }