BYOK कुंजी अपडेट करें

एक BYOK कुंजी अपडेट करता है: सक्षम/अक्षम, नाम बदलना, फ़ॉलबैक मोड बदलना, प्रति-मॉडल टॉगल (modelToggles), और लागू दायरा रीसेट (scopedApiKeyIds)। सभी फ़ील्ड वैकल्पिक; अपस्ट्रीम कुंजी स्वयं नहीं बदली जा सकती — बदलने के लिए हटाकर पुनः बनाएँ।

PATCH/api/v1/management/byok-keys/:id

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

पथ पैरामीटर

idआवश्यक

string

BYOK कुंजी id।

Body

enabled

boolean

पूरी कुंजी का मास्टर स्विच।

fallbackMode

string

अपस्ट्रीम विफल होने पर प्लेटफ़ॉर्म रूटिंग पर लौटना है या नहीं।

seamlessstrict

name

string

नया प्रदर्शन नाम।

1-200 chars

modelToggles

{canonicalId, enabled}[]

प्रति-मॉडल स्विच: प्रत्येक तत्व में canonicalId और enabled। केवल सूचीबद्ध मॉडल बदलते हैं; बाकी यथावत।

≤2000 items

scopedApiKeyIds

string[]

पूरी स्कोप सूची बदलता है: खाली array = पूरे संगठन पर लागू। जो id आपकी नहीं, 400 देता है।

≤200 items; must be your own keys

PATCH /api/v1/management/byok-keys/:id

1
2
3
4
curl -X PATCH https://bazaarlink.ai/api/v1/management/byok-keys/byok_abc123 \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fallbackMode": "strict", "modelToggles": [{"canonicalId": "openai/gpt-4o", "enabled": false}]}'

प्रतिक्रिया उदाहरण

अपडेट हुआ — अद्यतन { key } लौटाता है।

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "key": {
    "id": "byok_abc123",
    "ownerType": "org",
    "userId": null,
    "organizationId": "org_abc123",
    "name": "team-upstream",
    "baseUrl": "https://api.example-upstream.com/v1",
    "keyMask": "sk-abc…wxyz",
    "protocol": "openai",
    "enabled": true,
    "fallbackMode": "strict",
    "modelsStale": false,
    "lastVerifiedAt": "2026-07-29T00:00:00.000Z",
    "lastErrorAt": null,
    "lastErrorCode": null,
    "errorCount1h": 0,
    "createdAt": "2026-07-29T00:00:00.000Z",
    "updatedAt": "2026-07-29T00:00:00.000Z",
    "models": [
      {
        "canonicalId": "openai/gpt-4o",
        "upstreamModelId": "gpt-4o",
        "enabled": true
      }
    ],
    "scopedApiKeyIds": []
  }
}