version

Force Version Check

Force an immediate version check.

Triggers a version check regardless of when the last check was performed. May be rate limited by Plus server (1 request per hour per instance).

post/api/v1/instance/version/check

Request

  • The document declares no server URL.
  • Auth: OAuth 2 (password, token URL /api/v1/auth/token)

Cookies

access_tokenstring nullable

Response

Successful Response

successboolean required

Whether the version check succeeded

messagestring required

Human-readable status message

retry_after_secondsinteger nullable

Seconds to wait before retrying (if rate limited)

cachedboolean nullable

Whether the returned version_info is from cache (fallback after failed check)

Example response

{
  "message": "Version check completed successfully",
  "success": true,
  "version_info": {
    "changelog_url": "https://journiv.app/changelog",
    "current_version": "0.1.0-beta.9",
    "install_id": "550e8400-e29b-41d4-a716-446655440000",
    "last_check_success": true,
    "last_checked": "2025-12-09T10:30:00Z",
    "latest_version": "0.1.0-beta.11",
    "update_available": true,
    "update_url": "https://github.com/journiv/journiv/releases/tag/v0.1.0-beta.11"
  }
}

Changes

No recorded changes to this operation across all 9 revisions of this API.