Get server version

GET 
/version

Returns the version of the Gravitino server, with its build date and source commit. The Java client calls it when it connects, unless version checking is turned off, to check that it is compatible with the server.

Sign in with a bearer token or a local user's password; see Authentication.

Responses

200

The server version, with its build date and source commit.

application/vnd.gravitino.v1+json

Schema

Schema

code int32required

Possible values: [0]

Status code of the response

version

object

required

version stringrequired

The server version

compileDate stringrequired

When the server was built

gitCommit stringrequired

The source commit the server was built from

Example (from schema)

{
  "code": 0,
  "version": {
    "version": "string",
    "compileDate": "string",
    "gitCommit": "string"
  }
}

VersionResponse

{
  "code": 0,
  "version": {
    "version": "1.3.0",
    "compileDate": "06/10/2026 10:15:42",
    "gitCommit": "3f1c2a9d8e7b6a5c4d3e2f1a0b9c8d7e6f5a4b3c"
  }
}

5xx

The server hit an internal error that the client usually cannot fix by changing the request.

application/vnd.gravitino.v1+json

Schema

Schema

code integerrequired

Possible values: >= 1000 and <= 1100

HTTP response code

type stringrequired

Internal type definition of the error

message stringrequired

A human-readable message

stack string[]deprecated

Deprecated diagnostic stack trace. Enterprise omits it by default because it can expose internal implementation details. Operators can opt in for controlled diagnostics with gravitino.server.webserver.includeErrorStackTrace=true. See OWASP REST Security: Error handling and CWE-209.

Example (from schema)

{
  "code": 1002,
  "type": "string",
  "message": "string"
}

Example

{
  "code": 1002,
  "type": "RuntimeException",
  "message": "Internal Server Error",
  "stack": [
    "java.lang.RuntimeException: Internal Server Error"
  ]
}

Loading...