メインコンテンツへスキップ
POST
/
api
/
v1
/
policies
Create Policy
curl --request POST \
  --url https://api.agentwallex.com/api/v1/policies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "type": "spending_limit",
  "rules": {
    "max_transaction_amount": "500",
    "daily_limit": "5000",
    "monthly_limit": "50000"
  }
}
'
{
  "id": "<string>",
  "agent_id": "<string>",
  "type": "spending_limit",
  "rules": {
    "max_transaction_amount": "<string>",
    "daily_limit": "<string>",
    "monthly_limit": "<string>",
    "allowed_addresses": [
      "<string>"
    ],
    "blocked_addresses": [
      "<string>"
    ],
    "allowed_tokens": [
      "<string>"
    ],
    "max_count": 123,
    "window_seconds": 123,
    "timezone": "<string>",
    "allowed_hours": {
      "start": 11,
      "end": 11
    },
    "allowed_days": [
      4
    ],
    "threshold": "<string>",
    "timeout_seconds": 123,
    "approvers": [
      "jsmith@example.com"
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
ポリシーは、エージェントが実行できるトランザクションを制御します。すべてのトランザクションは、MPC 署名の前にエージェントのポリシーに対して評価されます。

​
リクエストボディ

​
agent_id
string
必須
このポリシーを関連付けるエージェント。
​
type
string
必須
ポリシータイプ。値：spending_limit、address_control、token_control、velocity_control、schedule、human_approval。
​
rules
object
必須
ポリシールールオブジェクト。構造は type によって異なります。

​
例

curl -X POST https://api.agentwallex.com/api/v1/policies \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "type": "spending_limit",
    "rules": {
      "max_transaction_amount": "500",
      "daily_limit": "5000",
      "monthly_limit": "50000"
    }
  }'

承認

​
X-API-Key
string
header
必須

API key authentication. Keys are prefixed with awx_.

ボディ

application/json
​
agent_id
string
必須

Agent to attach this policy to.

​
type
enum<string>
必須

Policy type.

利用可能なオプション:
spending_limit,
address_control,
token_control,
velocity_control,
schedule,
human_approval
​
rules
object
必須

Policy rules object. Structure depends on the policy type.

レスポンス

Policy created successfully.

A policy that controls what transactions an agent is allowed to execute.

​
id
string

Unique policy identifier (e.g., pol_abc123).

​
agent_id
string

Agent this policy is attached to.

​
type
enum<string>

Policy type.

利用可能なオプション:
spending_limit,
address_control,
token_control,
velocity_control,
schedule,
human_approval
​
rules
object

Policy rules object. Structure depends on the policy type.

​
created_at
string<date-time>

ISO 8601 creation timestamp.

​
updated_at
string<date-time>

ISO 8601 last-update timestamp.