# Read how an agent improves

Source: https://docs.vlayers.ai/reference/agents/get-agent-improvement

`GET /v1/agents/{id}/improvement` · scope `workspace:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/improvement" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { improvement } = await voicelayer.agents.getImprovement('<agent-id>');
console.log(improvement.autoShip.enabled);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.get_improvement("<agent-id>")
print(result.improvement.auto_ship.enabled)
```

## Response `200`

```json
{
  "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"
  }
}
```
