WayloAIWaylo Docs
APIReferenceAgents

Save agent draft

PUT
/agents/{id}/draft

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

Authorization

api-key
headerAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>

Path Parameters

id*string

Header Parameters

Authorization*string

Your API key.

Request Body

application/json
  1. body
baseVersion*number
Range1 <= value
config*

Response Body

Success

application/json
  1. response
baseVersion*number
config*
updatedAt*string
Formatdate-time
Example Request
curl -X PUT 'https://api.poc.app.waylovoice.ai/agents/string/draft' \  -H 'Authorization: Bearer sk_waylo_...' \  -H 'Content-Type: application/json' \  -d '{  "baseVersion": 1,  "config": {}}'
Example Response
{  "baseVersion": 0,  "config": {    "name": "string",    "greeting": "string",    "systemPrompt": "string",    "language": "en",    "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": "8c4666aa-d43d-4196-b78a-f94040b1db76",    "presetId": "catalog_order_assistant",    "toolFeedbackOverrides": {      "property1": {        "ack": [          "string"        ],        "filler": [          "string"        ]      },      "property2": {        "ack": [          "string"        ],        "filler": [          "string"        ]      }    },    "spokenReply": true,    "spokenReplyPrompt": "string",    "documentIds": [      "2c049485-836c-4789-bec1-8a3d53fe6852"    ],    "toolIds": [      "95659032-40b7-428d-bf46-562a2c5d3aa2"    ],    "destinationIds": [      "31dc64b4-c492-4487-8989-c766bc35e76d"    ]  },  "updatedAt": "2019-08-24T14:15:22Z"}

Restore agent version POST

Make a past configuration the current one, as a new version — `version` never goes back. Documents deleted since are skipped and listed in `skippedDocuments`. Restoring the current configuration creates no version. **Access:** workspace_admin · API key `agents:write`

Update agent PATCH

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`