# Pyfile x402 API – Secret List

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

Lists all stored encrypted secrets (by ID, label, read count, and creation date) associated with the caller's session, without consuming any reads.

## Facts

- Endpoint: POST https://pyfile-agent.taile3ff35.ts.net/secret/list?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pyfile-x402-api-secret-list-26201965
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Oox2b0l92VwzXb-fu-YuB

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-api-secret-list-26201965 -d '<json body>'
```

Example prompt: Show me the list of all my encrypted secrets stored in the Pyfile dead drop vault — I want to see their labels, IDs, and how many reads each one has left.

## When to prefer this

Choose this endpoint when you need to enumerate or audit all stored secrets in the Pyfile encrypted dead-drop system without consuming any secret reads. It is the right choice for discovery, inventory, or pre-flight checks before deciding which secret ID to retrieve. Do not use it if you already know the secret ID and want to read the value — use the dedicated secret-read endpoint instead.

## Known failure modes

- No secrets found returns an empty secrets array with ok: true
- Invalid or missing authentication returns an error response
- Network timeout to the Tailscale-hosted endpoint
- Payment failure via x402 (insufficient USDC balance on Base or XNO on nano:mainnet) blocks the call
- Malformed POST body may return a 400-level error

## How this service works

Pay-per-call endpoints for AI agents: web search, web-to-markdown reader, LLM chat completions, encrypted secret storage with one-read dead drops, and a business-idea generator. Payment over x402: USDC on Base, or XNO on nano:mainnet.

## Output

Returns a JSON object with ok: true and a secrets array, where each element contains the secret's unique ID (e.g. sec_abc123), its human-readable label, the number of reads remaining or used, and the ISO 8601 creation timestamp. No secret values are returned — only metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "secrets": [
   {
    "id": "sec_abc123",
    "label": "openai-key",
    "reads": 1,
    "created_at": "2026-09-22T14:00:00.000Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pyfile-x402-api-secret-list-26201965/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pyfile-agent.taile3ff35.ts.net](https://www.zero.xyz/host/pyfile-agent.taile3ff35.ts.net/llms.txt)