# Pyfile x402 Secret Retrieval API

> Pyfile x402 Secret Retrieval API 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-23).

Retrieves a stored secret by its ID and access token, returning the decrypted value, label, and read count.

## Facts

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

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-retrieval-api-fce55368 -d '<json body>'
```

Example prompt: Retrieve my stored secret with ID 'sec_abc123' using access token 'tok_xyz789' and tell me its decrypted value and how many times it's been read.

## When to prefer this

Use this endpoint when you need to retrieve a previously stored secret by its unique ID and a paired access token, especially when you also want to track how many times the secret has been read. Suitable for agent workflows that need to fetch credentials, passphrases, or sensitive values stored via the Pyfile secret system.

## Known failure modes

- Invalid or expired access token returns an error or ok:false
- Secret ID not found returns a not-found error
- Unauthorized access attempt rejected
- Network timeout reaching Tailscale-hosted service
- Malformed request body missing required fields

## How this service works

Retrieve a stored secret by id + access token. Returns the decrypted value, label and read count.

## Output

Returns a JSON object with a boolean 'ok' status, the secret's 'id', its decrypted 'value' string, an optional human-readable 'label', and an integer 'reads' count indicating how many times the secret has been retrieved.

## 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",
      "value"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "ok": {
       "type": "boolean"
      },
      "label": {
       "type": "string",
       "description": "Optional human-readable label."
      },
      "reads": {
       "type": "integer",
       "description": "Number of times the secret has been read."
      },
      "value": {
       "type": "string",
       "description": "The decrypted secret value."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pyfile-x402-secret-retrieval-api-fce55368/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)