Safe4 authorize
safe4_authorizeDecide whether a proposed agent payment should proceed.
Settled per call in USDC over x402. Called without payment it
returns the price list rather than a decision; call it again with the
signed payload to receive one.
The task and the two allow-lists are the principal's constraints, not
the agent's: they are what the purchase is tested against, so an agent
that writes its own task is grading its own homework. Safe4 records
every field it was given in the audit entry and marks the task context
as request-supplied, so a substituted constraint is visible afterwards.
Args: task: The task the agent was given, as stated by its principal. purchase: What is being bought. purchase_purpose: Why this purchase serves the task. amount: Decimal amount as a string, for example "25.00". currency: Currency of the proposed payment, for example "USDC". counterparty: Who would receive the payment. service_category: Category of the thing being bought. allowed_service_categories: Categories the principal permits. allowed_counterparties: Optional payees the principal permits. When supplied, payment to anyone else is denied. task_id: Optional caller-side task identifier, echoed into the audit. payment: An x402 payment payload for this call. Omit to receive the price list instead of a decision.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | ||
| amount | Yes | ||
| payment | No | ||
| task_id | No | ||
| currency | Yes | ||
| purchase | Yes | ||
| counterparty | Yes | ||
| purchase_purpose | Yes | ||
| service_category | Yes | ||
| allowed_counterparties | No | ||
| allowed_service_categories | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||