API Reference

REST over HTTPS, JSON only. Authentication uses bearer tokens issued by /v1/auth/session. All responses include X-Request-ID for tracing.

Base URL

https://api.yahsway.app

Authentication

POST/v1/auth/session● operational

Exchange OAuth or email/password for a session token.

Sample response

{
  "ok": true,
  "data": {
    "id": "obj_01H...",
    "createdAt": "2026-01-09T16:00:00Z"
  }
}

POST/v1/auth/refresh● operational

Refresh an expiring session token.

Sample response

{
  "ok": true,
  "data": {
    "id": "obj_01H...",
    "createdAt": "2026-01-09T16:00:00Z"
  }
}

DELETE/v1/auth/session● operational

Revoke the current session.

Sample response

{
  "ok": true,
  "data": {
    "id": "obj_01H...",
    "createdAt": "2026-01-09T16:00:00Z"
  }
}