---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/tools/retrievables/variables/updateRetrievableTool.md
description: 'Replace an existing {@link @nhtio/adk!Retrievable} by `id`.'
---

# Variable: updateRetrievableTool

```ts
const updateRetrievableTool: Tool<SpooledJsonArtifact<unknown>>;
```

Defined in: [batteries/tools/retrievables/index.ts:166](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/batteries/tools/retrievables/index.ts#L166)

Replace an existing [@nhtio/adk!Retrievable](../../../../common/classes/Retrievable.md) by `id`.

## Remarks

The model supplies `id` plus any subset of `content` / `trustTier` / `source` / `kind` /
`score`; omitted fields retain their prior values. `updatedAt` is always bumped;
`createdAt` is preserved. Returns an error when no retrievable with the supplied `id` is
found.