Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Intents

Create RPC intent

Create an intent to execute an RPC method on a wallet. The intent must be authorized by either the wallet owner or signers before it can be executed.

post/v1/intents/wallets/{wallet_id}/rpc

Path parameters

wallet_idstring required

ID of the wallet.

Headers

privy-app-idstring required

ID of your Privy app.

privy-request-expirystring

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

Request body

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Response

Created RPC intent.

created_atnumber required

Unix timestamp when the intent was created

created_by_display_namestring required

Display name of the user who created the intent

created_by_idstring

ID of the user who created the intent. If undefined, the intent was created using the app secret

custom_expiryboolean required

Whether this intent has a custom expiry time set by the client. If false, the intent expires after a default duration.

dismissal_reasonstring

Human-readable reason for dismissal, present when status is 'dismissed'

dismissed_atnumber

Unix timestamp when the intent was dismissed, present when status is 'dismissed'

expires_atnumber required

Unix timestamp when the intent expires

intent_idstring required

Unique ID for the intent

rejected_atnumber

Unix timestamp when the intent was rejected, present when status is 'rejected'

resource_idstring required

ID of the resource being modified (wallet_id, policy_id, etc)

status'pending' | 'processing' | 'executed' | 'failed' | 'expired' | 'rejected' | 'dismissed' required

Current status of an intent.

intent_type'RPC' required

Example response

{
  "authorization_details": [
    {
      "display_name": "Admin Key Quorum",
      "members": [
        {
          "signed_at": null,
          "type": "user",
          "user_id": "did:privy:clabcd123"
        }
      ],
      "threshold": 1
    }
  ],
  "created_at": 1741834854578,
  "created_by_display_name": "developer@example.com",
  "created_by_id": "did:privy:clabcd123",
  "custom_expiry": false,
  "expires_at": 1741921254578,
  "intent_id": "clpq1234567890abcdefghij",
  "intent_type": "RPC",
  "request_details": {
    "body": {
      "caip2": "eip155:8453",
      "chain_type": "ethereum",
      "method": "eth_sendTransaction",
      "params": {
        "transaction": {
          "to": "0x0000000000000000000000000000000000000000",
          "value": 1
        }
      }
    },
    "method": "POST",
    "url": "https://api.privy.io/v1/wallets/xs76o3pi0v5syd62ui1wmijw/rpc"
  },
  "resource_id": "xs76o3pi0v5syd62ui1wmijw",
  "status": "pending"
}