# three.ws Auth Session Lifecycle Health Check

> three.ws Auth Session Lifecycle Health Check is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Runs a session lifecycle health check against the three.ws authentication system, verifying that session creation, expiry, refresh, and validation all pass with measured latencies.

## Facts

- Endpoint: POST https://three.ws/api/x402/auth-health?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-auth-session-lifecycle-health-check-18b76fcb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N00yUFvUrRP16dbD9EUmA

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 three-ws-auth-session-lifecycle-health-check-18b76fcb -d '<json body>'
```

Example prompt: Run the session_lifecycle health check on the three.ws auth system and tell me whether all steps — create, expire, refresh, and validate — are passing and what their latencies are.

## When to prefer this

Use this endpoint when you need to programmatically confirm that the three.ws session authentication pipeline is fully operational before making dependent calls, during incident investigation, or as part of a continuous uptime monitor. It is the only supported health-check mode (session_lifecycle) for this platform's auth layer.

## Known failure modes

- One or more lifecycle steps (create/expire/refresh/validate) returns pass:false, with failed_step identifying the culprit
- Network timeout if the auth backend is fully unreachable
- Payment failure via x402 if the $0.001 USDC micropayment cannot be processed
- Unexpected response schema if the service is in a degraded state

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a timestamp, per-step results (create, expire, refresh, validate) each with a pass boolean and latency_ms, an overall all_pass flag, total latency_ms, and the name of the first failed_step (or null if all passed).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "session_lifecycle"
   ],
   "type": "string",
   "default": "session_lifecycle",
   "description": "Health-check mode. Only \"session_lifecycle\" is supported."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-06-28T00:00:00Z",
  "steps": {
   "create": {
    "pass": true,
    "latency_ms": 8
   },
   "expire": {
    "pass": true,
    "latency_ms": 2
   },
   "refresh": {
    "pass": true,
    "latency_ms": 11
   },
   "validate": {
    "pass": true,
    "latency_ms": 3
   }
  },
  "all_pass": true,
  "latency_ms": 38,
  "failed_step": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-auth-session-lifecycle-health-check-18b76fcb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)