दस्तऐवज

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

एक 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⁶).