Headless API

Use wrok from any HTTP client, script, or automation. The headless API provides full access to every feature with API key authentication.

Base URL

https://wrok-agent.fly.dev

Authentication

All authenticated endpoints accept a Bearer token:

Authorization: Bearer wrok_sk_...

Get an API key

# Sign up
curl -X POST https://wrok-agent.fly.dev/api/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "secret", "name": "Your Name"}'

# Or log in
curl -X POST https://wrok-agent.fly.dev/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "secret"}'

Both return api_key in the response. Each login creates a new key; old keys remain valid.

Available endpoints

Category	Endpoints
Auth	signup, login, me, api-keys, device-code
Profile	GET/PUT /api/v1/profile
Career Data	GET /api/v1/career-data
Roles	CRUD /api/v1/roles
Skills	POST/DELETE /api/v1/skills
Education	CRUD /api/v1/education
Projects	CRUD /api/v1/projects
Blog	CRUD /api/v1/blog-posts, preferences, publish
Job Apps	CRUD /api/v1/job-applications
Profile Page	CRUD, publish, generate /api/v1/profile-page
Resume	regenerate, latest, delete /api/v1/resumes
Chat	POST /chat, /chat/stream (SSE)
Coding	GET /api/v1/coding-profile, coding-machines

See the API Reference for full endpoint documentation.

Error handling

All errors return JSON with a detail field:

{"detail": "Invalid or expired API key"}  // 401
{"detail": "Not found"}                    // 404
{"detail": "Rate limited"}                 // 429