# authorship: generated by API Evangelist tooling. Stamped 2026-08-18
# on the file's own generator header (roadmap#64). An unmarked file is
# NOT assumed to be ours -- absence of evidence was never stamped.
x-method: generated
overlay: 1.0.0
info:
title: API Evangelist enhancements for Vers Orchestrator Control Plane API
version: 1.0.0
extends: openapi/vers-openapi-original.json
actions:
- target: $.info
update:
x-apievangelist-provider: vers
x-apievangelist-product: "Vers — branchable compute / microVM control plane"
x-apievangelist-homepage: https://vers.sh/
x-apievangelist-docs: https://docs.vers.sh/
x-apievangelist-github: https://github.com/hdresearch
x-apievangelist-base-url: https://api.vers.sh
x-apievangelist-auth: "bearer API key (VERS_API_KEY)"
- target: $.servers
update:
- url: https://api.vers.sh
description: "Vers production API (base path /api/v1). The published spec omits servers[]; added by API Evangelist from the documented VERS_URL."
- target: $.info
update:
x-apievangelist-conventions:
pagination: offset/limit
idempotency: per-request idempotency-key override (SDK request layer)
retries: exponential backoff, honors Retry-After
error_envelope: "custom JSON {error, success:false} (not RFC 9457)"
x-apievangelist-sdks: "9 official languages (vers-sdk), auto-generated by Sterling"
x-apievangelist-mcp:
- "vers mcp serve (platform tools)"
- "https://docs.vers.sh/mcp (docs)"
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.