> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# setWalletAuthorizationScope

> Binds a wallet to an authorization scope, or moves it to another one.

## Import

Call this method on a server-side ParaRestClient created with your server secret key.

```ts theme={null}
import { ParaRestClient } from "@getpara/rest-sdk";
```

async

Binds a wallet to an authorization scope, or moves it to another one.

Copy method signature

### Returns

[`Promise<PermissionsV2AuthorizationScopeBindingView>`](/v3/references/types/permissions#permissionsv2authorizationscopebindingview)

The new binding and its revision.

## Route

A wallet needs a binding before a conditional approval can open for it. The wallet must belong to your app or be connected to it. Send `0` as `expectedRevision` for the first binding.

```text theme={null}
PUT /v1/permissions-v2/wallets/{walletId}/authorization-scope
```

> [!NOTE]
>
> An approval case is open while it is `pending`, and after it completes until it is used to sign or expires. Para refuses a change that would invalidate open cases until you confirm it. A confirmed change ends those cases as `invalidated`, and their requests need a new attempt.
>
> Through the API, a refused change returns `409` with code `APPROVAL_CASES_AFFECTED` and the case IDs in `affectedCaseIds`, and nothing changes. To confirm it, send the same change again with `force: true`.
>
> In the REST SDK, the error is a `ParaRestError` with that `code`, and `ParaRestError.affectedCaseIds` lists the cases.

## Example

The first binding uses revision `0` and the scope your backend chose.

```ts theme={null}
const binding = await para.setWalletAuthorizationScope(walletId, {
  expectedRevision: 0,
  authorizationScopeId,
});
```

## Errors

A non-success response throws `ParaRestError` with the HTTP `status`, the error `code` and a `message`. [Permissions errors](/v3/references/permissions/errors) lists every error code.

An empty path argument throws `ParaRestValidationError` before the request is sent.

| Status | Code | When |
| - | - | - |
| 403 | `FORBIDDEN` | The wallet does not belong to your app. |
| 403 | `PERMISSIONS_V2_EXTENSION_UNAVAILABLE` | Conditional approvals are not enabled for your API key. Contact Para to enable them. |
| 404 | `NOT_FOUND` | The wallet does not exist. |
| 409 | `CONFLICT` | `expectedRevision` is not the current revision. Read the binding again and retry. |
| 409 | `APPROVAL_CASES_AFFECTED` | The change would invalidate open approval cases. `affectedCaseIds` on the error lists them. Retry with `force: true` to apply the change. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.