# MutationResult

Defined in: [react/src/types.ts:915](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L915)

Result from createMutation.

## Type Parameters

### Service

`Service` = [`BaseActor`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/baseactor/)

### Method

`Method` *extends* [`FunctionName`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/functionname/)\<`Service`\> = [`FunctionName`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/functionname/)\<`Service`\>

### Transform

`Transform` *extends* [`TransformKey`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/transformkey/) = `"candid"`

## Properties

### useMutation

> **useMutation**: \<`TOnMutateResult`\>(`options?`) => `UseMutationResult`\<[`ReactorReturnOk`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnok/)\<`Service`, `Method`, `Transform`\>, [`ReactorReturnErr`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnerr/)\<`Service`, `Method`, `Transform`\>, [`ReactorArgs`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorargs/)\<`Service`, `Method`, `Transform`\>, `TOnMutateResult`\>

Defined in: [react/src/types.ts:930](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L930)

React hook for the mutation.
Accepts options to override/extend the factory config.

#### Type Parameters

##### TOnMutateResult

`TOnMutateResult` = `unknown`

#### Parameters

##### options?

[`MutationHookOptions`](https://ic-reactor.b3pay.net/v3/libs/interfaces/mutationhookoptions/)\<`Service`, `Method`, `Transform`, `TOnMutateResult`\>

#### Returns

`UseMutationResult`\<[`ReactorReturnOk`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnok/)\<`Service`, `Method`, `Transform`\>, [`ReactorReturnErr`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnerr/)\<`Service`, `Method`, `Transform`\>, [`ReactorArgs`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorargs/)\<`Service`, `Method`, `Transform`\>, `TOnMutateResult`\>

#### Example

```ts
// With invalidateQueries to auto-update balance after transfer
const { mutate } = icpTransferMutation.useMutation({
  invalidateQueries: [userBalanceQuery], // Auto-invalidate after success!
})
```

***

### execute

> **execute**: (`args`) => `Promise`\<[`ReactorReturnOk`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnok/)\<`Service`, `Method`, `Transform`\>\>

Defined in: [react/src/types.ts:945](https://github.com/B3Pay/ic-reactor/blob/ad82a03d03149c25f0d0f63e453f62e284c28b02/packages/react/src/types.ts#L945)

Execute the update call outside React. It runs in the QueryClient's
MutationCache with the factory's options and callbacks, as `useMutation()`
does without hook options. It resolves with the method's result and
rejects with the call's error.

#### Parameters

##### args

[`ReactorArgs`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorargs/)\<`Service`, `Method`, `Transform`\>

#### Returns

`Promise`\<[`ReactorReturnOk`](https://ic-reactor.b3pay.net/v3/libs/type-aliases/reactorreturnok/)\<`Service`, `Method`, `Transform`\>\>