# Undo a learned vocabulary entry

Remove a word learned from one of the caller's own corrections. The word is not learned again automatically; it can still be added by hand. Any other entry answers `VOCABULARY_NOT_LEARNED`.

When a person corrects a dictated text, each corrected word is added to their own private vocabulary at once and listed in the `learned` field of [Submit a correction for auto-learn](/api-reference/dictation/submit-a-correction-for-auto-learn). This endpoint is the undo for one of those words. A copy that automatic sharing has already added to a shared list stays in that list.

#### Path Parameters

**`entry_id`** string required

The learned entry's ID, as returned in `learned[].entry_id`.

## Returns

**`entry_id`** string

The entry that was removed.

**`undone`** boolean

Always `true`.

Example

```bash cURL
curl -X POST "https://api.aitronos.com/v1/vocabulary/entries/pdict_3c7e9a1f5b2d4086/undo-learn" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.aitronos.com/v1/vocabulary/entries/pdict_3c7e9a1f5b2d4086/undo-learn",
    headers={"X-API-Key": api_key},
)

print(response.json())
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/vocabulary/entries/pdict_3c7e9a1f5b2d4086/undo-learn', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey
  }
});

const data = await response.json();
console.log(data);
```

**Response:**


```json 200 OK
{
  "entry_id": "pdict_3c7e9a1f5b2d4086",
  "undone": true
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to perform this action.",
    "system_message": "Caller lacks the rights this operation needs.",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "VOCABULARY_ENTRY_NOT_FOUND",
    "message": "This vocabulary entry does not exist or you cannot see it.",
    "system_message": "Vocabulary entry not found.",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```


```json 422 Unprocessable Entity
{
  "success": false,
  "error": {
    "code": "VOCABULARY_NOT_LEARNED",
    "message": "This vocabulary entry was not learned from a correction.",
    "system_message": "This vocabulary entry was not learned from a correction.",
    "type": "validation_error",
    "status": 422,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```

## Related Resources

- [Submit a correction for auto-learn](/api-reference/dictation/submit-a-correction-for-auto-learn) — Where learned words come from.
- [Delete a vocabulary entry](/api-reference/vocabulary/delete-a-vocabulary-entry) — Delete any entry you can edit.
- [Vocabulary API](/api-reference/vocabulary/_index) — Overview of lists, entries and settings.