Skip to main content
POST
/
v2
/
policies
Create Policy
curl --request POST \
  --url https://api.dfns.io/v2/policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '{
  "name": "chainalysis prescreening policy",
  "activityKind": "Wallets:Sign",
  "rule": {
    "kind": "ChainalysisTransactionPrescreening",
    "configuration": {
      "alerts": {
        "alertLevel": "LOW",
        "categoryIds": []
      },
      "exposures": {
        "direct": {
          "categoryIds": []
        }
      },
      "addresses": {
        "alertLevel": "LOW",
        "categoryIds": []
      },
      "fallbackBehaviours": {
        "skipUnscreenableTransaction": false,
        "skipUnsupportedNetwork": false,
        "skipUnsupportedAsset": false,
        "skipChainalysisFailure": false
      }
    }
  },
  "action": {
    "kind": "Block"
  },
  "filters": {
    "walletId": {
      "in": [
        "wa-4sql3-a6ct4-8j2q8ih86d853rgg",
        "wa-j9btt-5s9o8-i3r8373ddg0usn3"
      ]
    }
  }
}'
{
  "id": "<string>",
  "name": "<string>",
  "status": "Active",
  "dateCreated": "<string>",
  "dateUpdated": "<string>",
  "activityKind": "Registry:Addresses:Modify",
  "rule": {
    "kind": "AlwaysTrigger",
    "configuration": {}
  },
  "action": {
    "kind": "RequestApproval",
    "approvalGroups": [
      {
        "name": "<string>",
        "quorum": 2,
        "approvers": {
          "userId": {
            "in": [
              "<string>"
            ]
          }
        },
        "initiatorCanApprove": true
      }
    ],
    "autoRejectTimeout": 2
  },
  "filters": {}
}

Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

Required Permissions

Policies:Create: Always required.

Authorizations

Authorization
string
header
required
X-DFNS-USERACTION
string
header
required

Body

application/json
  • Registry:Addresses:Modify
  • Permissions:Assign
  • Permissions:Modify
  • Policies:Modify
  • Registry:ContractSchemas:Modify
  • Wallets:Sign
  • Wallets:IncomingTransaction
name
string
required
activityKind
enum<string>
required
Available options:
Registry:Addresses:Modify
rule
object
required
action
object
required
  • RequestApproval
  • Block
filters
object

Response

200 - application/json
  • Registry:Addresses:Modify
  • Permissions:Assign
  • Permissions:Modify
  • Policies:Modify
  • Registry:ContractSchemas:Modify
  • Wallets:Sign
  • Wallets:IncomingTransaction
id
string
required
name
string
required
status
enum<string>
required
Available options:
Active,
Archived
activityKind
enum<string>
required
Available options:
Registry:Addresses:Modify
rule
object
required
action
object
required
  • RequestApproval
  • Block
dateCreated
string
dateUpdated
string
filters
object