SaaS APIagents

Create agent

View as Markdown

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
modelstringRequired
namestringRequired
providerstringRequired
allowedModelslist of stringsOptional
budgetdoubleOptional
budgetActionstringOptional
budgetWindowstringOptional
departmentIdstringOptional
descriptionstringOptional
environmentstringOptional
expiresAtstringOptional
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