# agent402.tools Memory Namespace Grant

> agent402.tools Memory Namespace Grant is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Grants another wallet read or readwrite access to your agent memory namespace, enabling cross-agent coordination with optional time-to-live expiration.

## Facts

- Endpoint: POST https://agent402.tools/api/memory/grant
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-memory-namespace-grant-91b6c4ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OGw-mfdAnDK-GpCI8FXKH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-tools-memory-namespace-grant-91b6c4ca -d '<json body>'
```

Example prompt: Grant wallet 0xAbC123...def readwrite access to my memory namespace, and make it expire after 3600 seconds so the other agent can coordinate with me temporarily.

## When to prefer this

Use this endpoint when you need two or more distinct wallet-based agents to coordinate through a shared memory namespace — especially when you want time-bounded or permanently delegated access. Prefer this over manual state-passing when agents operate asynchronously or independently and need a shared source of truth.

## Known failure modes

- Invalid grantee wallet address format returns a 400 error
- Invalid mode value (not 'read' or 'readwrite') returns a 400 validation error
- Missing required fields returns a 400 error
- Unauthorized caller (no valid x402 payment or wrong namespace owner) returns a 402 or 401 error
- TTL value out of acceptable range may return a 422 error
- Namespace does not exist or caller has no ownership returns a 403 error

## How this service works

Share your namespace with another wallet so different agents can coordinate through it. Grant read or readwrite access to a grantee wallet, optionally with a TTL. This is the cross-agent sharing a single agent cannot provide for itself.

## Output

A confirmation that the access grant has been recorded, indicating the grantee wallet address, the access mode (read or readwrite), and whether a TTL was applied to auto-expire the grant.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string",
   "description": "\"read\" or \"readwrite\""
  },
  "grantee": {
   "type": "string",
   "description": "0x wallet to grant access to"
  },
  "ttlSeconds": {
   "type": "number",
   "description": "Optional: auto-expire the grant"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "readwrite",
  "owner": "0x…",
  "grantee": "0x1111…",
  "expiresAt": 1760086400
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-memory-namespace-grant-91b6c4ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)
