API Referenceai

Update an AI credential

View as Markdown
Update an AI credential label, stored key, default model, custom endpoint, or enabled state.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

credentialIdstringRequired

Headers

BCTRL-Subaccount-IdstringOptional
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.

Request

This endpoint expects an object.
apiKeystring or nullOptional
baseUrlstring or nullOptionalformat: "uri"
defaultModelstring or nullOptional
namestringOptional1-200 characters
statusenumOptional

Response

OK
createdAtdatetime
RFC 3339 timestamp with a UTC offset.
hasApiKeyboolean
idstring
namestring1-200 characters
providerenum
statusenum
updatedAtdatetime
RFC 3339 timestamp with a UTC offset.
baseUrlstringOptionalformat: "uri"
defaultModelstringOptional
subaccountIdstringOptional1-64 characters
Opaque identifier for a BCTRL subaccount.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error