setWalletAuthorizationScope

Import

import { ParaRestClient } from "@getpara/rest-sdk";

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.

PUT /v1/permissions-v2/wallets/{walletId}/authorization-scope

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.

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 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.

Overview

Client Methods

Actions

React Hooks

Signers & Integrations

Smart Accounts

Wallet Connectors

REST SDK

Types & Configuration

setWalletAuthorizationScope

Import

Route

Example

Errors

​Import

​Route

​Example

​Errors

Import

Route

Example

Errors