Update policy

PATCH

wallets

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.

number

Maximum USD value allowed per individual transaction.

number

Maximum total USD value allowed across all transactions in a 24-hour period.

array

Whitelist of Solana addresses permitted to receive transfers. Pass an empty array [] to allow all recipients.

boolean

Set to true to enable token swaps via the trade endpoint, or false to disable.

boolean

Set to true to allow liquidity pool interactions, or false to disable.

boolean

Set to true to allow prediction market interactions, or false to disable.

number

JWT token validity in hours. Changes take effect on the next authentication.

Response

boolean

true when the update succeeds.

number

HTTP status code.

string

Human-readable result message.

object

Show properties

object

The full updated policy after applying changes.

Show properties

number

Maximum USD value per transaction.

number

Maximum USD value per 24 hours.

array

Whitelist of allowed transfer recipients.

boolean

Whether trading is enabled.

boolean

Whether liquidity provision is enabled.

boolean

Whether prediction markets are enabled.

number

JWT token validity in hours.

Errors

Status	Description
`400`	Invalid field value or type
`401`	Missing or invalid Bearer token
`429`	Rate 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
    }
  }
}

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
    }
  }
}

Overview

Authentication

Wallet

Policy

Utility

Request body

Response

Errors

​Request body

​Response

​Errors

Request body

Response

Errors