Cloud Endpoints

Authentication, stored resumes, synchronization, publishing, and history operations for connected Rustume deployments.

Connected endpoints are available in hosted Rustume Cloud and when an open-source operator enables Cloud mode with PostgreSQL, WorkOS, and a session secret. See Environment Variables.

Authentication

MethodPathAuthDescription
GET/auth/loginNoneRedirect to WorkOS AuthKit
GET/auth/callbackOAuth stateExchange code and establish session
POST/auth/logoutCookie when presentDelete session and clear cookie
GET/auth/meCookieReturn the authenticated account

Resume storage

MethodPathDescription
GET/api/resumesList authenticated user’s summaries
POST/api/resumesCreate a resume
GET/api/resumes/{id}Fetch owned resume data
PUT/api/resumes/{id}Update title and/or resume data
DELETE/api/resumes/{id}Delete an owned resume
POST/api/resumes/importImport locally stored resumes
GET/api/resumes/exportBulk JSON export (max 50 resumes)
GET/api/resumes/export/pdfBulk PDF export as ZIP (max 50 resumes)

Export endpoints enforce a resume-count cap and route-specific rate limits:

JSON export uses the resume CRUD limit group; PDF export uses the PDF limit group (same as POST /api/render/pdf). See Rate Limits.

Connected workflows

The connected API also backs synchronization, public pages, version history, and scoped API keys. Consult the generated OpenAPI document for exact route bodies and responses in the deployed release.

These workflows are not feature entitlements tied to a hosted subscription. Operators running the open-source connected application can expose the same functional API surface.

Operational endpoints

MethodPathRequirementDescription
GET/healthNoneIncludes persistence checks when connected mode is configured
GET/metricsBearer METRICS_TOKENPrometheus exposition