Read how an agent improves

GET
/v1/agents/{id}/improvement

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.

Authorization

apiKey
headerAuthorizationBearer <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.

Path Parameters

id*string

The agent id.

Response Body

How the agent improves: its settings, the floors in force and the price of one proposal

application/json
  1. response
improvement*
Example Request
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"  }}