Update agent
Change any part of the configuration except its workspace. An update that changes the configuration bumps version and records it in the history; one that changes nothing, or only active, does not. documentIds and toolIds each replace their whole set. Refused (409) if the resulting tools would give the model one function name twice — two tools sharing a name, or a tool shadowing a builtin of the resulting preset.
Access: workspace_admin · API key agents:write
api-keyAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>id*stringapplication/json- body
name?stringlength <= 100greeting?stringlength <= 500systemPrompt?stringlength <= 20000language?string^[a-z]{2,3}$"en"sttProvider?stringsttModel?stringsttOptions?llmProvider?stringllmModel?stringllmOptions?ttsProvider?stringttsModel?stringttsVoiceId?stringttsOptions?runtimeConfig?catalogId?|uuidpresetId?|"catalog_order_assistant""item_capture_assistant"nulltoolFeedbackOverrides?spokenReply?booleantruespokenReplyPrompt?|length <= 1000active?booleandocumentIds?array<>items <= 100toolIds?array<>items <= 20destinationIds?array<>items <= 5Success
application/json- response
id*stringworkspaceId*stringname*stringgreeting*stringsystemPrompt*stringlanguage*stringsttProvider*stringsttModel*stringsttOptions*llmProvider*stringllmModel*stringllmOptions*ttsProvider*stringttsModel*stringttsVoiceId*stringttsOptions*runtimeConfig*catalogId*string|nullcatalog*presetId*string|nulltoolFeedbackOverrides*spokenReply*booleanspokenReplyPrompt*string|nulldocuments*array<>tools*array<>destinations*array<>version*numberactive*booleancreatedByUserId*|uuidcreatedByUserName*string|nullupdatedByUserId*|uuidupdatedByUserName*string|nullcreatedAt*stringdate-timeupdatedAt*stringdate-timecurl -X PATCH 'https://api.poc.app.waylovoice.ai/agents/string' \ -H 'Authorization: Bearer sk_waylo_...' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "workspaceId": "string", "name": "string", "greeting": "string", "systemPrompt": "string", "language": "string", "sttProvider": "string", "sttModel": "string", "sttOptions": { "property1": "string", "property2": "string" }, "llmProvider": "string", "llmModel": "string", "llmOptions": { "property1": "string", "property2": "string" }, "ttsProvider": "string", "ttsModel": "string", "ttsVoiceId": "string", "ttsOptions": { "property1": "string", "property2": "string" }, "runtimeConfig": { "endpointing": { "mode": "fixed", "minDelayMs": 300, "maxDelayMs": 1000, "alpha": 0.9 }, "vad": { "activationThreshold": 0.5, "minSpeechDurationMs": 50, "minSilenceDurationMs": 550 }, "backgroundAudio": { "sound": "off", "volume": 0.1, "delaySeconds": 0 }, "thinkingSound": { "enabled": false, "delaySeconds": 1.5, "volume": 0.3 }, "silenceTimeoutMs": 15000, "silenceRetryAttempts": 3 }, "catalogId": "string", "catalog": { "id": "string", "name": "string", "description": "string", "active": true }, "presetId": "string", "toolFeedbackOverrides": { "property1": { "ack": [ "string" ], "filler": [ "string" ] }, "property2": { "ack": [ "string" ], "filler": [ "string" ] } }, "spokenReply": true, "spokenReplyPrompt": "string", "documents": [ { "id": "string", "name": "string" } ], "tools": [ { "id": "string", "name": "string", "type": "api_request" } ], "destinations": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ], "version": 0, "active": true, "createdByUserId": "4d2aef9a-17b0-44e6-902e-616812033620", "createdByUserName": "string", "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e", "updatedByUserName": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}Save agent draft PUT
Create or replace the unpublished configuration. Its values are not validated until publish. Refused (409) when `baseVersion` is not the current version: a version written since deleted the draft this one would replace. **Access:** workspace_admin · API key `agents:write`
Create catalog POST
Open an empty catalog in a workspace. Items are added separately. **Access:** workspace_admin · API key `catalogs:write`