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

# Permissions actions

> Call permissions operations with an explicit Para client

Import actions from `@getpara/react-sdk` or `@getpara/react-sdk-lite`. Each action takes a Para client first, followed by the exact positional arguments of its core method, and returns the same promise. Actions do not require a React hook, but the supplied client must satisfy the method’s authentication requirements. An undefined client throws `no para instance`.

```typescript theme={null}
import { getUserPolicyParameters } from "@getpara/react-sdk";

const settings = await getUserPolicyParameters(para, policyId);
```

## Policy discovery

<a id="listpolicies" />

### listPolicies

Lists publicly discoverable active policies for the application. Targeted user and wallet definitions are excluded.

```typescript theme={null}
listPolicies(para: ParaCore | undefined): Promise<PermissionsV2PolicyListResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listpolicies).

<a id="getpolicy" />

### getPolicy

Reads a publicly discoverable active policy and its authored defaults.

```typescript theme={null}
getPolicy(para: ParaCore | undefined, policyId: string): Promise<PermissionsV2PolicyResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getpolicy).

<a id="listapplicablepolicies" />

### listApplicablePolicies

Lists active policies applicable to the signed-in user and selected wallet.

```typescript theme={null}
listApplicablePolicies(para: ParaCore | undefined, context: PermissionsV2WalletContext): Promise<PermissionsV2PolicyListResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listapplicablepolicies).

<a id="getapplicablepolicy" />

### getApplicablePolicy

Reads an active policy applicable to the signed-in user and selected wallet.

```typescript theme={null}
getApplicablePolicy(para: ParaCore | undefined, policyId: string, context: PermissionsV2WalletContext): Promise<PermissionsV2PolicyResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getapplicablepolicy).

## Consent

<a id="listuserpolicyconsents" />

### listUserPolicyConsents

Lists consent requests and current consent state for the selected user wallet.

```typescript theme={null}
listUserPolicyConsents(para: ParaCore | undefined, context: PermissionsV2ConsentListContext): Promise<PermissionsV2DelegationConsentDiscoveryResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listuserpolicyconsents).

<a id="getuserpolicyconsent" />

### getUserPolicyConsent

Reads the selected policy’s current consent state for a user wallet.

```typescript theme={null}
getUserPolicyConsent(para: ParaCore | undefined, policyId: string, context: PermissionsV2WalletContext): Promise<PermissionsV2DelegationConsentView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getuserpolicyconsent).

<a id="getpolicyconsenturl" />

### getPolicyConsentUrl

Creates a Portal URL for policy consent without first submitting a transaction.

```typescript theme={null}
getPolicyConsentUrl(para: ParaCore | undefined, params: { walletId: string; policyId: string }): Promise<string>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getpolicyconsenturl).

## Adjustable parameters

<a id="listuseradjustablepolicies" />

### listUserAdjustablePolicies

Lists policies with adjustable parameters available to the user.

```typescript theme={null}
listUserAdjustablePolicies(para: ParaCore | undefined): Promise<PermissionsV2UserAdjustablePolicyListResponse>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listuseradjustablepolicies).

<a id="getuserpolicyparameters" />

### getUserPolicyParameters

Reads parameter declarations, saved values, and the current settings revision.

```typescript theme={null}
getUserPolicyParameters(para: ParaCore | undefined, policyId: string): Promise<PermissionsV2UserParameterView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getuserpolicyparameters).

<a id="updateuserpolicyparameters" />

### updateUserPolicyParameters

Saves the signed-in user’s parameter values against the current policy version and settings revision.

```typescript theme={null}
updateUserPolicyParameters(para: ParaCore | undefined, policyId: string, body: PermissionsV2UserParameterSave): Promise<PermissionsV2UserParameterView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/updateuserpolicyparameters).

<a id="resetuserpolicyparameters" />

### resetUserPolicyParameters

Resets the signed-in user’s parameter values to the current policy defaults.

```typescript theme={null}
resetUserPolicyParameters(para: ParaCore | undefined, policyId: string, body: PermissionsV2UserParameterReset): Promise<PermissionsV2UserParameterView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/resetuserpolicyparameters).

<a id="listuserpolicyparameterhistory" />

### listUserPolicyParameterHistory

Lists saved parameter revisions for the user and policy.

```typescript theme={null}
listUserPolicyParameterHistory(para: ParaCore | undefined, policyId: string, options?: PermissionsV2HistoryOptions): Promise<PermissionsV2UserParameterHistory>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listuserpolicyparameterhistory).

## Approval configuration

<a id="listconfigurableapprovalrequirements" />

### listConfigurableApprovalRequirements

Lists approval requirements that expose configuration in an authorization scope.

```typescript theme={null}
listConfigurableApprovalRequirements(para: ParaCore | undefined, authorizationScopeId: string): Promise<PermissionsV2ConditionalRequirementList>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listconfigurableapprovalrequirements).

<a id="getconfigurableapprovalrequirement" />

### getConfigurableApprovalRequirement

Reads a configurable approval requirement in a specific policy version and authorization scope.

```typescript theme={null}
getConfigurableApprovalRequirement(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference): Promise<PermissionsV2ConditionalRequirementView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getconfigurableapprovalrequirement).

<a id="getapprovalconfiguration" />

### getApprovalConfiguration

Reads the stored configuration and revision for an approval requirement.

```typescript theme={null}
getApprovalConfiguration(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference): Promise<PermissionsV2AuthorizationConfigurationView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getapprovalconfiguration).

<a id="geteffectiveapprovalconfiguration" />

### getEffectiveApprovalConfiguration

Reads the approval requirement after applying its current configuration.

```typescript theme={null}
getEffectiveApprovalConfiguration(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference): Promise<PermissionsV2EffectiveAuthorizationConfiguration>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/geteffectiveapprovalconfiguration).

<a id="updateapprovalconfiguration" />

### updateApprovalConfiguration

Updates the configurable values explicitly permitted by an approval requirement.

```typescript theme={null}
updateApprovalConfiguration(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference, body: PermissionsV2AuthorizationConfigurationWrite): Promise<PermissionsV2AuthorizationConfigurationView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/updateapprovalconfiguration).

<a id="resetapprovalconfiguration" />

### resetApprovalConfiguration

Clears configured overrides and restores the requirement’s defaults.

```typescript theme={null}
resetApprovalConfiguration(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference, expectedRevision: number): Promise<PermissionsV2AuthorizationConfigurationView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/resetapprovalconfiguration).

<a id="listapprovalconfigurationhistory" />

### listApprovalConfigurationHistory

Lists configuration revisions for an approval requirement.

```typescript theme={null}
listApprovalConfigurationHistory(para: ParaCore | undefined, reference: PermissionsV2ApprovalRequirementReference): Promise<PermissionsV2AuthorizationConfigurationHistory>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listapprovalconfigurationhistory).

## Roles and scopes

<a id="getuserapprovalassignments" />

### getUserApprovalAssignments

Reads roles and attributes assigned to a user in an authorization scope.

```typescript theme={null}
getUserApprovalAssignments(para: ParaCore | undefined, authorizationScopeId: string): Promise<PermissionsV2AuthoritySetView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getuserapprovalassignments).

<a id="getuserapprovalcapabilities" />

### getUserApprovalCapabilities

Lists requirements the signed-in user is authorized to configure in an authorization scope.

```typescript theme={null}
getUserApprovalCapabilities(para: ParaCore | undefined, authorizationScopeId: string): Promise<PermissionsV2AuthorizationScopeCapabilities>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getuserapprovalcapabilities).

## Approval cases

<a id="listaccessibleapprovalcases" />

### listAccessibleApprovalCases

Lists approval cases accessible to the signed-in approver.

```typescript theme={null}
listAccessibleApprovalCases(para: ParaCore | undefined): Promise<{ cases: PermissionsV2ConditionalApprovalCaseView[] }>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listaccessibleapprovalcases).

<a id="getaccessibleapprovalcase" />

### getAccessibleApprovalCase

Reads an approval case accessible to the signed-in approver.

```typescript theme={null}
getAccessibleApprovalCase(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getaccessibleapprovalcase).

<a id="listinitiatedapprovalcases" />

### listInitiatedApprovalCases

Lists approval cases initiated by the signed-in user.

```typescript theme={null}
listInitiatedApprovalCases(para: ParaCore | undefined, options?: PermissionsV2CaseListOptions): Promise<PermissionsV2ConditionalApprovalCaseList>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/listinitiatedapprovalcases).

<a id="getinitiatedapprovalcase" />

### getInitiatedApprovalCase

Reads an approval case initiated by the signed-in user, without granting approval authority.

```typescript theme={null}
getInitiatedApprovalCase(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getinitiatedapprovalcase).

<a id="approveapprovalcase" />

### approveApprovalCase

Records an authenticated approval from the signed-in eligible approver.

```typescript theme={null}
approveApprovalCase(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/approveapprovalcase).

<a id="rejectapprovalcase" />

### rejectApprovalCase

Records a rejection from the signed-in eligible approver.

```typescript theme={null}
rejectApprovalCase(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/rejectapprovalcase).

<a id="getapprovalcasereviewurl" />

### getApprovalCaseReviewUrl

Creates a Portal URL to review an approval case accessible to the signed-in approver.

```typescript theme={null}
getApprovalCaseReviewUrl(para: ParaCore | undefined, params: { caseId: string }): Promise<string>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getapprovalcasereviewurl).

## Signature collection

<a id="createapprovalsignaturecollection" />

### createApprovalSignatureCollection

Creates a policy-governed signature collection for a transaction.

```typescript theme={null}
createApprovalSignatureCollection(para: ParaCore | undefined, body: PermissionsV2TransactionSignatureCollection): Promise<PermissionsV2ApprovalSignatureCollectionResult>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/createapprovalsignaturecollection).

<a id="getapprovalsigningpayload" />

### getApprovalSigningPayload

Reads the canonical signing payload for a participant eligible to sign in the current stage.

```typescript theme={null}
getApprovalSigningPayload(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ApprovalSigningPayload>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getapprovalsigningpayload).

<a id="submitapprovalsignature" />

### submitApprovalSignature

Submits a signature and signer wallet for backend verification and collection.

```typescript theme={null}
submitApprovalSignature(para: ParaCore | undefined, caseId: string, body: PermissionsV2ConditionalApprovalSignature): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/submitapprovalsignature).

<a id="getapprovalsignatures" />

### getApprovalSignatures

Reads the completed signature bundle for the authenticated collection initiator.

```typescript theme={null}
getApprovalSignatures(para: ParaCore | undefined, caseId: string): Promise<PermissionsV2ApprovalSignatures>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getapprovalsignatures).

<a id="signapprovaltransaction" />

### signApprovalTransaction

Fetches the case’s canonical signing payload, signs with the selected wallet, and submits the signature.

```typescript theme={null}
signApprovalTransaction(para: ParaCore | undefined, params: SignApprovalTransactionParams): Promise<PermissionsV2ConditionalApprovalCaseView>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/signapprovaltransaction).

## Usage

<a id="getuserpolicyusage" />

### getUserPolicyUsage

Reads a current spending-usage snapshot for a policy and user wallet.

```typescript theme={null}
getUserPolicyUsage(para: ParaCore | undefined, policyId: string, context: PermissionsV2UsageContext): Promise<PermissionsV2PolicyUsage>
```

[Arguments, result, and Portal behavior](/v3/references/core/permissions/getuserpolicyusage).