메인 콘텐츠로 건너뛰기
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.