API Reference

Authentication

Most endpoints require a license key in the Authorization header:

Authorization: Bearer PYV-XXXX-XXXX-XXXX

Returns API health and version.

curl https://api.pyvorin.com/health

Validate a license key. The raw key is hashed (SHA-256) before transmission.

Get a summary of the stored license.

Submit a compile job. Returns a job_id for async polling.

Field	Type	Required	Description
`source`	string	Yes*	Raw Python source (only if upload enabled).
`workload_hash`	string	Yes*	SHA-256 hash of source.
`function_name`	string	No	Function to compile. Empty = whole module.
`backend`	string	No	Default: `native`.
`opt_level`	int	No	0–3. Default: `3`.
`strict`	bool	No	Fail on warnings. Default: `false`.
`bundle`	object	No	Project bundle for local imports.

* Either source or workload_hash must be provided.

Poll compile job status. Status values: queued, compiling, complete, failed, timeout.

List recent jobs. Query params: limit, status.

Download compiled artifact ZIP.

Send a usage event. Events are non-billable if correctness_match=false, fallback_used=true, or backend_used != "native".