VersionExistsEnvelope

The version_exists refusal from POST /v1/deploys. It is an error envelope plus the versionId that already holds this exact content, so a redeploy of unchanged configuration can activate that version rather than stopping.

  • code
    Type: ErrorCodeenum
    required

    An error code. The control plane returns the first group; the realtime edge additionally returns invalid_token, token_expired, and not_member on the routes included here. origin_not_allowed (403) is returned by BOTH hosts to a browser whose Origin isn't registered for the resolved environment (POST /v1/tokens/anonymous on the control plane; the client hot-path publish/history/members routes on the realtime edge) — reason names the exact origin and the fix (portal origins add <origin> --env <envId>). Unlike other errors, this response always carries Access-Control-Allow-Origin for the request's own (unregistered) Origin, or a browser couldn't read the message either.

    values
    • unauthorized
    • forbidden
    • not_found
    • validation_failed
    • conflict
    • rate_limited
    • content_too_large
    • not_permitted
  • versionId
    Type: string
    required

    The content-addressed id (cfg_...) of the version that already holds this content.

  • reason
    Type: string

    A human-readable explanation.