Architecture

API Reference

REST endpoints exposed by the Go API.

Buyer documentation is provided in English.

All endpoints are prefixed with /api/v1 and return the standard envelope. Authenticated routes expect an Authorization header carrying a bearer token.

Authentication

Method	Path	Description
POST	/auth/register	Create an owner account and organization
POST	/auth/login	Exchange credentials for tokens
POST	/auth/forgot-password	Request a password reset
POST	/auth/reset-password	Consume a reset token
POST	/auth/change-password	Change the signed in password
GET	/auth/me	Current user and organization

Jobs

Method	Path	Description
GET	/jobs	Paginated list with filters
POST	/jobs	Create a job
GET	/jobs/{id}	Job detail
PUT	/jobs/{id}	Update a job
PATCH	/jobs/{id}/status	Change status
DELETE	/jobs/{id}	Soft delete

Candidates

Method	Path	Description
GET	/candidates	Paginated list with score filters
GET	/candidates/{id}	Candidate with resume and analysis
PATCH	/candidates/{id}/status	Move through the pipeline
DELETE	/candidates/{id}	Soft delete candidate
POST	/jobs/{id}/resumes	Bulk resume upload, multipart
POST	/jobs/{id}/candidates/import	CSV profile import, multipart

The full request and response contract is in docs/API.md in the template package. Lite does not serve Swagger UI.