Skip to main content
Next, for resources owned by your key quorum of team members, create intents to execute actions like wallet updates, policy updates, signatures, or transactions. Intents are a resource in the Privy API that represent an intent to execute an action that will be asynchronously authorized by team members submitting approvals in the Privy Dashboard. Once a sufficient number of approvals is collected, the intent will be authorized and executed. At a high-level, there are two ways to create intents in Privy:
  • Via the Dashboard: From the Wallets and Policies pages of the Privy Dashboard, you can create an intent to update an existing wallet or policy that is owned by a key quorum of your team members.
  • Via the REST API: From the REST API, you can create an intent to update a wallet, update a policy, or execute a signature or transaction.
Intents expire 72 hours after creation, and must be approved within this window.
Learn more below on creating intents for the following flows.

Update wallet

Create an intent to update a wallet

Update policy

Create an intent to update a policy

Execute signature or transaction

Create an intent to execute a signature or transaction

​
Update wallet

Create intents to update a wallet via the Privy Dashboard or REST API.

​
Via the Dashboard

To create an intent to update a wallet via the Dashboard, visit the Wallets page of the Dashboard and select your desired wallet. Click Update wallet and make the changes you’d like to make. Finally, select Propose changes to create your intent to update the wallet.

​
Via the REST API

To create an intent to update a wallet via the REST API, make a PATCH request to 
https://api.privy.io/v1/apps/{app_id}/intents/wallets/{wallet_id}
This endpoint accepts the same request body as Privy’s synchronous Update wallet endpoint, but does not require authorization signatures to be provided in the request. Instead, the intent will be authorized asyncrhonously and executed when sufficient authorizations have been met. From the response, note the returned intent_id. You can use this ID later to view the status of the intent, how many authorizations have been collected, and what the execution status is. View the full API reference for this endpoint below.

Create an intent to update a wallet

View API reference for creating an intent to update a wallet.

​
Update policy

Create intents to update a policy via the Privy Dashboard or REST API.

​
Via the Dashboard

To create an intent to update a wallet via the Dashboard, visit the Policies page of the Dashboard and select your desired policy. Make your desired changes to the policy and click Propose changes to create your intent to update the policy.

​
Via the REST API

To create an intent to update a policy via the REST API, make a PATCH request to 
https://api.privy.io/v1/apps/{app_id}/intents/policies/{policy_id}
This endpoint accepts the same request body as Privy’s synchronous Update policy endpoint, but does not require authorization signatures to be provided in the request. Instead, the intent will be authorized asyncrhonously and executed when sufficient authorizations have been met. From the response, note the returned intent_id. You can use this ID later to view the status of the intent, how many authorizations have been collected, and what the execution status is. View the full API reference for this endpoint below.

Create an intent to update a policy

View API reference for creating an intent to update a policy.

​
Execute signature or transaction

Create intents to execute a signature or transaction via the REST API. Executing signatures and transactions currently cannot be initiated from the Privy Dashboard.

​
Via the REST API

To create an intent to update a policy via the REST API, make a POST request to 
https://api.privy.io/v1/apps/{app_id}/intents/wallets/{wallet_id}/rpc
This endpoint accepts the same request body as Privy’s synchronous RPC endpoint, but does not require authorization signatures to be provided in the request. Instead, the intent will be authorized asynchronously and executed when sufficient authorizations have been met. From the response, note the returned intent_id. You can use this ID later to view the status of the intent, how many authorizations have been collected, and what the execution status is. View the full API reference for this endpoint below.

Create an intent to execute a signature or transaction

View API reference for creating an intent to execute a signature or transaction

​
Update key quorum

You can also create an intent to update the key quorum of team members you initially created, to update the quorum’s name, members, or authorization threshold. This intent must be authorized by a sufficient number of members of the existing quorum in order to be executed.

​
Via the Dashboard

To create an intent to update a key quorum via the Dashboard, visit the Authorization page of the Dashboard and select your desired key quorum. Select Update key quorum, make your desired changes, and select propose changes to create your intent.

​
Via the REST API

To create an intent to update a policy via the REST API, make a PATCH request to 
https://api.privy.io/v1/apps/{app_id}/intents/key_quorums/{key_quorum_id}
This endpoint accepts the same request body as Privy’s synchronous Update key quorum endpoint, but does not require authorization signatures to be provided in the request. Instead, the intent will be authorized asyncrhonously and executed when sufficient authorizations have been met. From the response, note the returned intent_id. You can use this ID later to view the status of the intent, how many authorizations have been collected, and what the execution status is. View the full API reference for this endpoint below.

Create an intent to update a key quorum

View API reference for creating an intent to update a key quorum.