SaaS SDKSaaS APImaster-keys

Create master key

View as Markdown

Create a new master key (provider API key). Owner or admin. Provider keys are unlimited across tiers. Raw key is encrypted before storage.

Headers

AuthorizationstringRequired

Bearer {access_token}

X-Workspace-IdstringRequired
Workspace UUID

Request

label, provider, and apiKey are required; OpenAI/Anthropic keys require at least 20 characters and other provider keys at least 10; baseUrl and modelsInfo are optional

apiKeystringRequired20-500 characters

Must be 20-500 characters. Provider-specific prefixes and characters are validated.

labelstringRequired1-100 characters
providerstringRequired
baseUrlstringOptional
modelsInfomap from strings to objectsOptional
Optional provider model pricing keyed by model ID.

Response

data: created master key

baseUrlstringOptional
createdAtstringOptional
departmentslist of stringsOptional
idstringOptional
labelstringOptional
lastUsedAtstringOptional
lastVerifiedAtstringOptional
maskedKeystringOptional
providerstringOptional
requestsintegerOptional
spenddoubleOptional
statusstringOptional
updatedAtstringOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error