Saltar al contenido principal
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>",
  "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"
}
Las políticas controlan qué transacciones puede ejecutar un agente. Cada transacción se evalúa según las políticas del agente antes de la firma MPC.

​
Cuerpo de la solicitud

​
agent_id
string
requerido
Agente al que se asociará esta política.
​
type
string
requerido
Tipo de política. Valores: spending_limit, address_control, token_control, velocity_control, schedule, human_approval.
​
rules
object
requerido
Objeto de reglas de la política. La estructura depende de type.

​
Ejemplo

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

Autorizaciones

​
X-API-Key
string
header
requerido

API key authentication. Keys are prefixed with awx_.

Cuerpo

application/json
​
agent_id
string
requerido

Agent to attach this policy to.

​
type
enum<string>
requerido

Policy type.

Opciones disponibles:
spending_limit,
address_control,
token_control,
velocity_control,
schedule,
human_approval
​
rules
object
requerido

Policy rules object. Structure depends on the policy type.

Respuesta

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.

Opciones disponibles:
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.