Career Profile

Your career profile is the foundation of everything in wrok. It stores your work experience, skills, projects, and education — and drives resume generation, profile pages, and job tailoring.

Profile overview

Your profile contains:

  • Contact info — title, summary, phone, location, LinkedIn, GitHub
  • Roles — work experience with title, company, dates, and markdown descriptions
  • Skills — categorized skills with proficiency levels and years of experience
  • Projects — side projects, open source, and portfolio items
  • Education — degrees, institutions, fields, and GPA

Update your profile

curl -X PUT https://wrok-agent.fly.dev/api/v1/profile \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Software Engineer",
    "summary": "10 years building scalable web applications.",
    "location": "San Francisco, CA"
  }'

Add work experience

Each role has a title, company, dates, and a markdown description of your responsibilities and achievements.

curl -X POST https://wrok-agent.fly.dev/api/v1/roles \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Engineer",
    "company": "Stripe",
    "start_date": "2022-01-01",
    "is_current": true,
    "content": "Led payments infra team. Reduced latency by 40%."
  }'

Add skills

Skills are categorized and include proficiency levels. Adding a skill with the same name updates the existing one (upsert).

curl -X POST https://wrok-agent.fly.dev/api/v1/skills \
  -H "Authorization: Bearer $WROK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Python",
    "category": "language",
    "proficiency": "advanced",
    "years_of_experience": 8
  }'

Categories: language, framework, tool, soft_skill

Get all career data

curl https://wrok-agent.fly.dev/api/v1/career-data \
  -H "Authorization: Bearer $WROK_KEY"

Returns profile, roles, skills, projects, and education in one response.