Skip to main content

Talent Intake — Quick Reference

Fast, practical guide to ValkyrAI’s Talent Intake system: start the backend, run the frontend, and use the main API endpoints.

Start the Backend​

cd valkyrai
mvn clean package -DskipTests
java -jar target/valkyrai-*.jar

Health check

curl http://localhost:8080/v1/careers/health

Public APIs (most-used)​

  • POST /v1/careers/apply — submit application (multipart: resume file + metadata)
  • GET /v1/careers/opportunities — list opportunities
  • GET /v1/careers/opportunities/{id} — details

Example: Submit application​

curl -X POST http://localhost:8080/v1/careers/apply \
  -F "email=applicant@example.com" \
  -F "fullName=Jane Doe" \
  -F "resume=@resume.pdf"

Recruiter APIs (protected)​

  • PUT /v1/careers/applications/{id}?status=INTERVIEW_SCHEDULED

Frontend (dev)​

cd web/typescript/valkyr_labs_com
npm install
npm start

Frontend components: ApplyNow modal, Careers landing page; ensure ToastProvider is mounted.

Troubleshooting​

  • 413 Payload too large: increase upload limits
  • 403/401: check authentication & roles
  • Invalid resume uploads: validate MIME type and max size (default 5MB)

See also: Complete Onboarding to ValorIDE