---
title: "Element Versions hooks"
description: "Hand-written shim. Implementation is generated; see ./element-versions.gen."
section: "Libraries"
group: "React hooks"
order: 414
---

## Hooks

### `useCreateElementVersion` `mutation`

Create an element version.

```ts
useCreateElementVersion(options?: MutationOpts<ElementVersion, CreateElementVersionParams>)
```

**Types:** [ElementVersion](/types/element-version) · [CreateElementVersionParams](/types/create-element-version-params)

### `useDeleteElementVersion` `mutation`

Soft-delete an element version.

```ts
useDeleteElementVersion(options?: MutationOpts<SuccessResponse, string>)
```

**Types:** [SuccessResponse](/types/success-response)

### `useListElementVersions` `query`

List element versions.

```ts
useListElementVersions(params?: Omit<ListElementVersionsParams, | > & { filter?: ElementVersionFilter; orderBy?: ElementVersionOrderBy[]; } & ElementVersionShorthands, options?: QueryOpts<Page<ElementVersion>>)
```

**Types:** [ListElementVersionsParams](/types/list-element-versions-params) · [ElementVersionFilter](/types/element-version-filter) · [ElementVersionOrderBy](/types/element-version-order-by) · [ElementVersionShorthands](/types/element-version-shorthands) · [Page](/types/page) · [ElementVersion](/types/element-version)

### `usePurgeElementVersion` `composite`

Permanently delete a soft-deleted element version.

```ts
usePurgeElementVersion(options?: MutationOpts<SuccessResponse, PurgeElementVersionParams>)
```

**Types:** [SuccessResponse](/types/success-response) · [PurgeElementVersionParams](/types/purge-element-version-params)

### `useRestoreElementVersion` `composite`

Restore a soft-deleted element version.

```ts
useRestoreElementVersion(options?: MutationOpts<ElementVersion, string>)
```

**Types:** [ElementVersion](/types/element-version)

### `useRetrieveElementVersion` `query`

Get an element version by ID.

```ts
useRetrieveElementVersion(id: string, options?: QueryOpts<ElementVersion>)
```

**Types:** [ElementVersion](/types/element-version)