ModelVI
ModelVI API · v1
ModelVI API

Status & Changelog

Live operational status for the ModelVI API — available to every agency via API keys or the hosted MCP — a full history of changes, and our promise: we never break v1.

Live status

Refreshes automatically every 30 seconds. Publishing health reflects real activity across the fleet.

    The v1 compatibility promise

    What every integrator can rely on, in writing.

    • v1 is stable and never breaks. Once a field, endpoint, or behavior ships in /api/partner/v1, it stays. We do not remove fields, rename them, change their type, or alter response shapes.
    • Changes are additive only. New endpoints and new optional fields may appear at any time. Your existing integration keeps working unchanged — new capabilities are opt-in.
    • New request fields are always optional. We never add a required parameter to an existing endpoint. Defaults preserve today's behavior.
    • Breaking changes mean a new version. If we ever must break compatibility, it ships under a new path (e.g. /api/partner/v2). v1 keeps running alongside it.
    • Deprecations are announced, never silent. Anything slated for removal is listed here first, with a minimum 90-day notice and a documented migration path before it is touched.
    • The contract is machine-readable. The full OpenAPI 3 spec is served live at GET /api/partner/v1/openapi.json (partner-key authenticated) — drop it into Postman or a codegen tool.

    Changelog

    Newest first. Every entry below is additive — nothing was removed or changed.

    v1.42026-07-17Added
    • Self read: GET /agencies/self returns your own partner profile, role, and wholesale balance.
    • Client balance: fund or reclaim a client's balance directly from your wholesale prefund.
    v1.32026-07-10Added
    • Client lifecycle: per-client and bulk update / pause / resume for the accounts you manage.
    • Default retail price: set your default price, inherited automatically by every new client you create.
    v1.22026-06-28Added
    • Proxy management: list, assign, and rotate proxies for your models — owner-scoped to your tenant.
    • Consolidated dashboard: one rolled-up view across all of your sub-agencies and their models.
    v1.12026-06-18Added
    • Content upload & publishing: POST /api/upload then append per item to a model's vault, each with its own caption and tags.
    • Schedule, history, comments, and block-list endpoints — the full posting surface.
    v1.02026-06-01Launched
    • Public ModelVI API launch. Key-based auth (Authorization: Bearer mvk_<key>), tenant-scoped by construction.
    • Core surface: models, accounts, agencies (clients), balances, and the unauthenticated liveness endpoint GET /version.
    • Live OpenAPI 3 specification at GET /api/partner/v1/openapi.json.