# Pyfile x402 Secret Store (PUT)

> Pyfile x402 Secret Store (PUT) is a paid API for AI agents from pyfile-agent.taile3ff35.ts.net:10000, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Encrypts and stores a secret (credential, token, API key) at rest using AES-256-GCM and returns a unique ID plus access token for later retrieval.

## Facts

- Endpoint: POST https://pyfile-agent.taile3ff35.ts.net:10000/secret/put?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pyfile-x402-secret-store-put-873c5fc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B1UNtvoKZeWFru1j4DIgL

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 pyfile-x402-secret-store-put-873c5fc7 -d '<json body>'
```

Example prompt: Please securely store this API key for me — 'sk-abc123XYZ987' — encrypted at rest, so you can retrieve it in a future session using the ID and access token you get back.

## When to prefer this

Choose this endpoint when an AI agent needs to persist sensitive credentials, tokens, or keys across multiple runs or sessions without storing them in plaintext. It is ideal for agent-to-agent secret handoff or when an agent's runtime state includes secrets that must survive restarts. Prefer this over in-memory storage or environment variables when AES-256-GCM encryption at rest and a token-gated retrieval mechanism are needed. Best suited for small secrets up to 16KB.

## Known failure modes

- Payload exceeds 16KB limit — request rejected with error
- Missing or malformed input body — 400-level error
- Payment failure or insufficient USDC balance — 402 Payment Required
- Server unavailable on the Tailscale network — connection error
- Secret not stored if access_token is lost — no recovery mechanism

## How this service works

Store a secret (credential, token, key) for later retrieval — encrypted at rest (AES-256-GCM). Returns an id + access token; fetch later by id+token. Max 16KB. For agent state that must survive across runs.

## Output

Returns a JSON object with 'ok' (boolean success flag), 'id' (unique secret identifier string), and 'access_token' (bearer token required to read or delete the secret later). Both the id and access_token must be retained to retrieve the secret in a future call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json",
     "description": "Output payload format."
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "id",
      "access_token"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Secret id; use with the access token to fetch later."
      },
      "ok": {
       "type": "boolean"
      },
      "note": {
       "type": "string"
      },
      "access_token": {
       "type": "string",
       "description": "Bearer token required to read or delete the secret."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pyfile-x402-secret-store-put-873c5fc7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pyfile-agent.taile3ff35.ts.net:10000](https://www.zero.xyz/host/pyfile-agent.taile3ff35.ts.net%3A10000/llms.txt)