Files

Resume upload staging and parse-only helpers before creating or updating candidates.

Key APIs

Method	Path	Purpose
POST	/v1/files/resume-upload-url	Presigned PUT URL and temp key
POST	/v1/files/resume-parse	Extract text and suggest form fields

Business Rules

• Temp keys are scoped to the caller’s organization.
• Parse requires readable extracted text; it does not create or update candidates.
• Attach flow promotes temp keys to permanent storage via candidates API.

Dependencies

• S3 (presigned upload and read)
• OpenAI (structured field suggestions from resume text)