← Developer Hub
CRM
LP CRM
Investors
CFO
Transactions
Connection guide
Platform walkthrough
VDR Module
Virtual data rooms for deal diligence and LP onboarding — create rooms, upload documents, answer Q&A, and run semantic search over your document set.
This module reference is for an authorized platform workspace. Use the
connection guide for OAuth and workspace-key
setup. DDQ task enrollment does not enable these platform APIs.
Data Models
Model Description Key Fields
DealRoom A secure data room with folder structure, members, and document set id, name, room_type, status, organization_id, root_folder_id
Document A file stored in a room folder id, original_filename, folder_id, file_type, uploaded_by, created_at
Folder Hierarchical folder in a room id, name, parent_id, room_id
Question LP-visible Q&A question in a room id, folder_id, body, status, ref, is_public
DealRoomMember User access record for a room id, room_id, user_id, email, role
Room Types
Type Use case
company_investmentStandard diligence room for a deal
fund_investmentFund-level data room (investor-facing)
gp_fund_raiseLP fundraising room with ODD access enabled
Cross-Module Links
Direction How to navigate
DealRoom → CRM (Deal) Find Transaction where linked_room_id = room.id → Transaction.deal_id → Deal
DealRoom → LP CRM LPInvestor.lp_room_id = room.id → GET /api/v1/fundos/lp-crm/investors?lp_room_id={id}
Note: To link a Deal to a VDR room, create a Transaction with deal_id set, then set Transaction.linked_room_id. This is the canonical cross-module join — Deal has no direct room_id.
Quickstart (3 steps)
Step 1 — Authenticate
export FUNDOS_API_KEY=vdr_your_key_here
Step 2 — Create a diligence room
curl -X POST https://www.kela.com/api/v1/rooms \
-H "Authorization: Bearer $FUNDOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Acme DD Room", "room_type": "company_investment"}'
# → {"success": true, "data": {"id": 12, "name": "Acme DD Room", "room_type": "company_investment"}}
Step 3 — Upload a document and search it
# Upload
curl -X POST https://www.kela.com/api/v1/rooms/12/documents \
-H "Authorization: Bearer $FUNDOS_API_KEY" \
-F "file=@pitch_deck.pdf"
# → {"success": true, "data": {"id": 88, "original_filename": "pitch_deck.pdf"}}
# Semantic search
curl -X POST https://www.kela.com/api/v1/rooms/12/search \
-H "Authorization: Bearer $FUNDOS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "management team backgrounds"}'
Webhook Events
Event Trigger Payload
room.created
New DealRoom created
{"room_id", "name", "room_type"}
document.uploaded
Document uploaded to a room
{"room_id", "document_id", "filename", "uploader_id"}
qa.answered
Q&A question receives an answer
{"room_id", "question_id", "question_text"}
Endpoints
Method Path Description Required Params
GET /api/v1/rooms List accessible rooms —
GET /api/v1/rooms/{id} Get room detail + stats room_id
POST /api/v1/rooms Create room name, room_type
GET /api/v1/rooms/{id}/documents List documents room_id
POST /api/v1/rooms/{id}/documents Upload document (multipart) file
GET /api/v1/rooms/{id}/documents/{doc_id}/download-url Get signed download URL room_id, doc_id
POST /api/v1/rooms/{id}/search Semantic search with citations query
GET /api/v1/rooms/{id}/qa List Q&A questions room_id
POST /api/v1/rooms/{id}/qa/{qid}/answer Post an answer (admin only) body
GET /api/v1/rooms/{id}/members List members room_id
GET /api/v1/rooms/{id}/audit-log Get audit log room_id
Error Codes
Code HTTP Hint
room_not_found404 Verify room_id against GET /api/v1/rooms
document_not_found404 Verify document_id against GET /api/v1/rooms/{id}/documents
room_name_taken409 A room with this name already exists in your org
invalid_room_type400 room_type must be company_investment, fund_investment, or gp_fund_raise
question_not_found404 Verify qa_id against GET /api/v1/rooms/{id}/qa
→ Provisioned platform walkthrough | Module contract JSON | Changelog