Product documentation
API overview
Base URL for hosted: https://foliyo.dev (API under /api). Self-host uses your own domain.
Auth
Opaque Bearer tokens (stored server-side, revoked on logout).
| Method | Path | Notes |
|---|---|---|
| POST | /api/auth/login | Returns token + user |
| POST | /api/auth/logout | Requires Bearer |
| GET | /api/auth/me | Current user |
Library & publish
| Area | Paths |
|---|---|
| Profile | /api/profile |
| Content | /api/skills, /projects, /experience, /education, /certifications, /languages, /social-links |
| Portfolios | /api/portfolios |
| Resumes | /api/resumes |
| Export | GET /api/resumes/:id/export (Pro HTML/PDF path) · GET /api/resumes/:id/export.fio (Foliyo Resume Spec package) |
| Applications | /api/applications — manual tracker |
| AI import | POST /api/import/resume — hosted Pro; returns draft only |
Public & spec endpoints
| Method | Path | Notes |
|---|---|---|
| GET | /u/:handle | Public portfolio |
| GET | /r/:token | Shared resume HTML |
| GET | /v1/verify/:token | Live `.fio` / share verify |
| POST | /v1/verify | Offline signature check |
| POST | /v1/status/notify | ATS status webhook (HMAC) |
Full field-level reference lives in the OSS repo. Interchange format: Foliyo Resume Spec.