Propose condition set item intents

Propose an intent to add items to a condition set or to replace all of its items. The condition set’s owner must authorize the intent. Privy rejects intents for a condition set with no owner. Update those condition sets directly instead. Each endpoint accepts the same request body as its synchronous counterpart (add items, replace items) but does not require authorization signatures in the request.

Intents expire 72 hours after creation by default. Signers must authorize them within this window.

Add items

Make a POST request to /v1/intents/condition_sets/{condition_set_id}/condition_set_items with the values to add. Values are unique within a condition set. Privy rejects the intent if any value already exists in the set.

REST API
Node SDK

curl -X POST https://api.privy.io/v1/intents/condition_sets/<condition_set_id>/condition_set_items \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>" \
  -H "Content-Type: application/json" \
  -d '[
    {"value": "0x5B8b13e8f3E6Ec888e88C77cf039EB6281F21D93"},
    {"value": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2"}
  ]'

import {PrivyClient} from '@privy-io/node';

const client = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

const intent = await client.intents().createConditionSetItems('insert-condition-set-id', {
  condition_set_items_request_body: [
    {value: '0x5B8b13e8f3E6Ec888e88C77cf039EB6281F21D93'},
    {value: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'}
  ]
});

console.log(intent.intent_id, intent.status, intent.authorization_details);

View the API reference for adding items through an intent.

Replace items

Make a PUT request to /v1/intents/condition_sets/{condition_set_id}/condition_set_items with the full list of values. When the intent executes, Privy deletes every existing item and adds the values in the request. Any other change to the condition set’s items dismisses a pending replace intent. Propose a new intent with the updated list.

REST API
Node SDK

curl -X PUT https://api.privy.io/v1/intents/condition_sets/<condition_set_id>/condition_set_items \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>" \
  -H "Content-Type: application/json" \
  -d '[
    {"value": "0x5B8b13e8f3E6Ec888e88C77cf039EB6281F21D93"},
    {"value": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2"}
  ]'

import {PrivyClient} from '@privy-io/node';

const client = new PrivyClient({
  appId: 'your-app-id',
  appSecret: 'your-app-secret'
});

const intent = await client.intents().updateConditionSetItems('insert-condition-set-id', {
  condition_set_items_request_body: [
    {value: '0x5B8b13e8f3E6Ec888e88C77cf039EB6281F21D93'},
    {value: '0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2'}
  ]
});

console.log(intent.intent_id, intent.status, intent.authorization_details);

View the API reference for replacing items through an intent.

Next steps

Sign intents

Add authorization signatures to execute a proposed intent.

Intent status

Track an intent from proposal to execution.

Signatures and transactions

Wallet actions

Wallet automations

Signing and RPC

Intents

Transactions

Update condition set items

Add items

Replace items

Next steps

Sign intents

Intent status

​Add items

​Replace items

​Next steps

Sign intents

Intent status

Add items

Replace items

Next steps