API Reference
Complete REST API reference for the wrok career platform.
Base URL: https://wrok-agent.fly.dev · Auth: Authorization: Bearer wrok_sk_...
Authentication
POST/api/v1/auth/signupCreate a new accountPOST/api/v1/auth/loginLog in and get an API keyGET/api/v1/auth/meGet current authenticated userPOST/api/v1/auth/api-keysCreate a new API keyGET/api/v1/auth/api-keysList all API keysDELETE/api/v1/auth/api-keys/{id}Revoke an API keyProfile
GET/api/v1/profileGet your profilePUT/api/v1/profileUpdate your profileGET/api/v1/career-dataGet all career data (profile + roles + skills + projects + education)Roles
GET/api/v1/rolesList all rolesPOST/api/v1/rolesAdd a new rolePATCH/api/v1/roles/{id}Update a roleDELETE/api/v1/roles/{id}Delete a roleSkills
GET/api/v1/skillsList skills (filter by ?category=)POST/api/v1/skillsAdd or update a skill (upsert)DELETE/api/v1/skills/{id}Delete a skillEducation
GET/api/v1/educationList education entriesPOST/api/v1/educationAdd educationPATCH/api/v1/education/{id}Update educationDELETE/api/v1/education/{id}Delete educationProjects
GET/api/v1/projectsList projectsPOST/api/v1/projectsAdd a projectPATCH/api/v1/projects/{id}Update a projectDELETE/api/v1/projects/{id}Delete a projectBlog
GET/api/v1/blog-preferencesGet writing preferencesPUT/api/v1/blog-preferencesUpdate writing preferencesGET/api/v1/blog-postsList all blog postsPOST/api/v1/blog-postsCreate a blog postGET/api/v1/blog-posts/{id}Get a blog postPUT/api/v1/blog-posts/{id}Update a blog postDELETE/api/v1/blog-posts/{id}Delete a blog postPOST/api/v1/blog-posts/{id}/publishPublish a postPOST/api/v1/blog-posts/{id}/unpublishUnpublish a postJob Applications
GET/api/v1/job-applicationsList applications (filter by ?status=)POST/api/v1/job-applicationsCreate an applicationGET/api/v1/job-applications/{id}Get an applicationPATCH/api/v1/job-applications/{id}Update an applicationDELETE/api/v1/job-applications/{id}Delete an applicationProfile Page
GET/api/v1/profile-pageGet your profile pagePOST/api/v1/profile-pageCreate a profile pagePUT/api/v1/profile-pageUpdate profile pageDELETE/api/v1/profile-pageDelete profile pagePOST/api/v1/profile-page/publishPublish profile pagePOST/api/v1/profile-page/unpublishUnpublish profile pagePOST/api/v1/profile-page/generateAuto-generate from career dataGET/api/v1/profile-page/check-slug/{slug}Check slug availability (no auth)Resume
POST/api/v1/resumes/regenerateRegenerate resume from career dataGET/api/v1/resumes/latestGet latest resume (?format=json|yaml|markdown|pdf)DELETE/api/v1/resumesDelete all resumesChat
POST/chatSend message to AI agent (multipart)POST/chat/streamStream AI response (SSE, multipart)GET/api/v1/conversations/currentGet conversation historyDELETE/api/v1/conversations/currentClear conversationCoding Profile
GET/api/v1/coding-profileGet coding profileGET/api/v1/coding-machinesList development machinesAccount
DELETE/api/v1/user/resetDelete all data (destructive)Public (no auth)
GET/api/v1/public/profiles/{slug}View published profileGET/api/v1/public/profiles/{slug}/blogView published blogGET/api/v1/public/profiles/{slug}/blog/{post-slug}View published blog postGET/healthHealth check