Skip to main content
PATCH
/
wallets
/
me
/
policy
curl -X PATCH https://api.useknot.xyz/wallets/me/policy \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "maxSingleTransactionInUsd": 500,
    "dailyLimitInUsd": 2000,
    "allowTrading": true,
    "allowPredictionMarkets": false
  }'
{
  "status": true,
  "statusCode": 200,
  "message": "Policy updated successfully.",
  "data": {
    "policy": {
      "maxSingleTransactionInUsd": 500,
      "dailyLimitInUsd": 2000,
      "allowedRecipients": [],
      "allowTrading": true,
      "allowLiquidityProvision": true,
      "allowPredictionMarkets": false,
      "sessionExpirationHours": 168
    }
  }
}
Updates one or more policy fields for the agent. All fields are optional — only include the fields you want to change. The response returns the full updated policy.
Requires authentication via Bearer token.
To restrict transfers to specific addresses only, set allowedRecipients to an array of allowed Solana addresses. To allow transfers to any address, set it to an empty array [].

Request body

All fields are optional. Only include the fields you want to update.
maxSingleTransactionInUsd
number
Maximum USD value allowed per individual transaction.
dailyLimitInUsd
number
Maximum total USD value allowed across all transactions in a 24-hour period.
allowedRecipients
array
Whitelist of Solana addresses permitted to receive transfers. Pass an empty array [] to allow all recipients.
allowTrading
boolean
Set to true to enable token swaps via the trade endpoint, or false to disable.
allowLiquidityProvision
boolean
Set to true to allow liquidity pool interactions, or false to disable.
allowPredictionMarkets
boolean
Set to true to allow prediction market interactions, or false to disable.
sessionExpirationHours
number
JWT token validity in hours. Changes take effect on the next authentication.

Response

status
boolean
true when the update succeeds.
statusCode
number
HTTP status code.
message
string
Human-readable result message.
data
object

Errors

StatusDescription
400Invalid field value or type
401Missing or invalid Bearer token
429Rate limit exceeded
curl -X PATCH https://api.useknot.xyz/wallets/me/policy \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "maxSingleTransactionInUsd": 500,
    "dailyLimitInUsd": 2000,
    "allowTrading": true,
    "allowPredictionMarkets": false
  }'
{
  "status": true,
  "statusCode": 200,
  "message": "Policy updated successfully.",
  "data": {
    "policy": {
      "maxSingleTransactionInUsd": 500,
      "dailyLimitInUsd": 2000,
      "allowedRecipients": [],
      "allowTrading": true,
      "allowLiquidityProvision": true,
      "allowPredictionMarkets": false,
      "sessionExpirationHours": 168
    }
  }
}