SaaS APIagents

Create agent

View as MarkdownOpen in Claude

Create agent and auto-create Virtual Key. Returns fullToken once. Owner or admin.

Headers

AuthorizationstringRequired

Bearer {access_token}

X-Workspace-IdstringRequired
Workspace UUID

Request

name, provider, model, masterKeyId (required)

masterKeyIdstringRequired
namestringRequired
providerstringRequired
allowedModelslist of stringsOptional
budgetdoubleOptional
budgetActionstringOptional
budgetWindowstringOptional
departmentIdstringOptional
descriptionstringOptional
environmentstringOptional
expiresAtstringOptional
modelstringOptional
modelsInfomap from strings to objectsOptional

ModelsInfo 是 custom provider 时的模型价格，格式：{“modelId”: {“prompt”: 1.5, “completion”: 2.0}} 单位：美元 / 1M tokens

rateLimitRpmintegerOptional

Response

data: agent + virtualKey (id, keyPrefix, fullToken)

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error