Read how an agent improves
GET
The agent's improvement settings: whether it drafts fixes on its own and its monthly cap, whether it ships them on its own (under whose permission, and why it turned off if it did), whether you approve by text, and the floors in force: the fewest different contacts and person-made cases an automatic shipment needs.
Requires an API key with the workspace:read scope.
apiKeyheader
AuthorizationBearer <token>A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.
id*stringThe agent id.
How the agent improves: its settings, the floors in force and the price of one proposal
application/json- response
improvement*curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/improvement" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "improvement": { "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "autoDraft": { "enabled": true, "monthlyCapUsd": 20, "committedUsd": 1.4 }, "autoShip": { "enabled": false, "grantId": null, "grantedBy": null, "grantedByName": null, "costCeilingUsdPerSuccess": null, "offReason": null, "offAt": null }, "textApproval": { "enabled": true, "grantId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67", "mobileConfirmed": true }, "limits": { "autoShipMinContacts": 20, "autoShipMinOwnerCases": 5, "maxEvidenceCases": 20 }, "perProposalQuote": { "maxUsd": 1.4, "typicalUsd": 0.4, "draftMaxUsd": 0.2, "evidenceMaxUsd": 1.2 }, "updatedAt": "2026-10-20T15:04:05.000Z" }}