Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: empryo.com public Version API
version: 1.0.0
description: 'The read-only public surface of empryo.com — release metadata for the Empryo AI coding agent, plus the machine-readable content mirrors (llms.txt and per-page markdown). Empryo itself is a local tool: the primary programmatic interface is the CLI (`empryo --headless "" --json`), documented at https://empryo.com/docs/headless. No authentication; all endpoints are public GETs. Please cache: release data changes only on releases.'
contact:
name: Empryo
url: https://empryo.com/contact
servers:
- url: https://empryo.com
tags:
- name: Version
paths:
/api/version:
get:
operationId: getLatestRelease
summary: Latest Empryo release
description: 'The current release manifest: version string and the artifact filename for every platform/surface. Combine with the download host https://dl.empryo.com/v{version}/{file} to build a direct download URL. Identical to /latest.json.'
responses:
'200':
description: The current release manifest.
content:
application/json:
schema:
$ref: '#/components/schemas/ReleaseManifest'
'503':
description: Manifest temporarily unreadable.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Version
components:
schemas:
ReleaseManifest:
type: object
required:
- version
- files
description: 'The current Empryo release: version + artifact filenames. Download URL pattern: https://dl.empryo.com/v{version}/{file}; checksums at https://dl.empryo.com/v{version}/SHA256SUMS.txt.'
properties:
version:
type: string
description: Release version.
examples:
- 3.6.0-beta
files:
type: object
description: Map of platform/surface key → artifact filename (e.g. darwin-arm64, linux-x64, windows-zip, desktop-mac-arm64).
additionalProperties:
type: string
Error:
type: object
required:
- error
description: Structured error returned by every /api/* endpoint — never HTML.
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Machine-readable error code.
examples:
- not_found
- method_not_allowed
message:
type: string
description: Human-readable explanation.
hint:
type: string
description: Where to look next.