दस्तावेज़

टीम & वर्कस्पेस

एक BharatRouter खाता कई orgs से संबंधित हो सकता है। जब आप साइन अप करते हैं तो आपको एक व्यक्तिगत org मिलता है; आप team orgs भी बना सकते हैं या उनमें शामिल हो सकते हैं जो एक प्रीपेड बैलेंस, keys का एक सेट, और एकledger साझा करते हैं। एक org के अंदर, वर्कस्पेस keys और usage को environment या team के अनुसार समूहित करते हैं।

Orgs & स्विचिंग

Endpoint	यह क्या करता है
`GET /me/orgs`	वे orgs जिनसे आप संबंधित हैं, आपकी भूमिका और सदस्य संख्या के साथ (स्विचर सूची)।
`POST /me/orgs`	एक team org बनाएँ — आप उसके owner बन जाते हैं। प्रति उपयोगकर्ता अधिकतम 10 team orgs।
`POST /me/orgs/switch`	सक्रिय org स्विच करें और अपने सेशन को फिर से साइन करें।

आपका व्यक्तिगत org एकल-उपयोगकर्ता है — लोगों को जोड़ने के लिए एक team org बनाएँ। ₹100 का साइनअप क्रेडिट प्रति व्यक्ति है, न कि प्रति org, इसलिए नए team orgs ₹0 से शुरू होते हैं।

सदस्य & भूमिकाएँ

आप email द्वारा सदस्यों को जोड़ते हैं। एक आमंत्रण बनाया जाता है और एक सूचना email भेजा जाता है; सदस्यता तब स्थापित होती है जब आमंत्रित व्यक्ति स्वीकार करता है (उनके OAuth-सत्यापित email पर मिलान किया जाता है)। भूमिकाएँ:

भूमिका	कर सकता है
`owner`	billing, सदस्य भूमिकाएँ, और org को हटाना सहित सब कुछ। कम से कम एक owner हमेशा मौजूद होता है — अंतिम owner को पदावनत या हटाया नहीं जा सकता।
`admin`	keys, BYOK, routing, वर्कस्पेस को प्रबंधित करें, और सदस्यों को आमंत्रित करें — लेकिन owners को हटा नहीं सकते।
`member`	keys का उपयोग करें और org डेटा पढ़ें; collections को स्टार और फोर्क करें।

Endpoint	यह क्या करता है
`GET /me/members`	सक्रिय org के सदस्य और लंबित आमंत्रण।
`POST /me/members`	`email` + `role` (owner/admin) द्वारा आमंत्रित करें। प्रति org अधिकतम 50 सदस्य + लंबित।
`PATCH /me/members/:id`	किसी सदस्य की भूमिका बदलें (owner)।
`DELETE /me/members/:id`	किसी सदस्य को हटाएँ, या स्वयं org छोड़ दें (दूसरों को हटाने के लिए owner/admin)।
`DELETE /me/members/pending/:id`	एक लंबित आमंत्रण वापस लें (owner/admin)।

एक आमंत्रण स्वीकार करना

Endpoint	यह क्या करता है
`GET /me/invitations`	आपके लंबित आमंत्रण (आपके साइन-इन email से मेल खाते हुए)।
`POST /me/invitations/:id/accept`	org में शामिल हों।
`POST /me/invitations/:id/decline`	अस्वीकार करें।

वर्कस्पेस

एक वर्कस्पेस एक org के भीतर keys और usage का एक समूह है — staging बनाम production, या प्रति-team — जबकि org एकल वॉलेट और कानूनी पहचान रखता है। हर org में एकDefault वर्कस्पेस होता है जो हमेशा मौजूद रहता है और जिसे संग्रहीत नहीं किया जा सकता; जिन keys को आप कहीं और असाइन नहीं करते वे वहीं रहती हैं। जब आप किसी key कोबनाते हैं तो उसे किसी दूसरे वर्कस्पेस में असाइन करें। किसी वर्कस्पेस को संग्रहीत करना एक सॉफ्ट डिलीट है — एक संगठनात्मक सीमा, न कि एक किल स्विच, इसलिए इसकी keys काम करती रहती हैं।

Endpoint	यह क्या करता है
`GET /me/workspaces`	सक्रिय वर्कस्पेस उनकी सक्रिय-key संख्या के साथ।
`POST /me/workspaces`	एक बनाएँ (owner/admin)। प्रति org अधिकतम 20।
`PATCH /me/workspaces/:id`	नाम बदलें, मासिक ₹ बजट निर्धारित करें, या विवरण संपादित करें (owner/admin)।
`DELETE /me/workspaces/:id`	संग्रहीत करें (keys काम करती रहती हैं) (owner/admin)।

वर्कस्पेस बजट

एक वर्कस्पेस में मासिक ₹ बजट हो सकता है — एक खर्च सीमा, जो org के एकल वॉलेट से, उस वर्कस्पेस की प्रत्येक key पर लागू होती है। इसे लागू किया जाता है: एक बार जब IST कैलेंडर माह के लिए वर्कस्पेस का खर्च सीमा तक पहुँच जाता है, तो उसकी keys पर अनुरोध429 budget_exceeded के साथ अगले महीने तक या जब तक आप सीमा नहीं बढ़ाते, तब तक अस्वीकार कर दिए जाते हैं। इसे PATCH (owner/admin) के माध्यम से सेट या साफ़ करें; 0या null सीमा को हटा देता है।

PATCH /me/workspaces/:id
{ "monthly_budget_inr": 5000 }        // 0 or null clears the cap
→ { "workspace": { "id": 4, "name": "staging", "monthly_budget_uinr": 5000000000 } }

यह प्रति-key मासिक बजट का वर्कस्पेस-स्तरीय साथी है: एक key का अपना बजट उस एक key को सीमित करता है, जबकि वर्कस्पेस बजट पूरे वर्कस्पेस को सीमित करता है। दोनों में से कोई भी सीमा पहले टूट सकती है; दोनों 429 budget_exceeded लौटाते हैं और IST महीने की सीमा पर रीसेट होते हैं। GET /me/workspaces प्रत्येक वर्कस्पेस की सीमा (monthly_budget_uinr) और इस महीने तक उसका खर्च (spent_month_uinr) लौटाता है, दोनों माइक्रो-रुपये में (₹ × 10⁶)।