GoodMem
ReferenceClient SDKsPython SDK

System API

System API documentation for Python SDK

All URIs are relative to http://localhost:8080

MethodHTTP requestDescription
get_system_infoGET /v1/system/infoRetrieve server build metadata
initialize_systemPOST /v1/system/initInitialize the system

get_system_info

SystemInfoResponse get_system_info()

Retrieve server build metadata

Returns the server's advertised semantic version, git metadata, build timestamp, and optional capability flags. The endpoint is intentionally unauthenticated so bootstrap tooling can call it before API keys exist.

Example

import goodmem_client
from goodmem_client.models.system_info_response import SystemInfoResponse
from goodmem_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8080/v1/default
# See configuration.py for a list of all supported configuration parameters.
configuration = goodmem_client.Configuration(
    host = "http://localhost:8080/v1/default"
)

# Enter a context with an instance of the API client
with goodmem_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = goodmem_client.SystemApi(api_client)

    try:
        # Retrieve server build metadata
        api_response = api_instance.get_system_info()
        print("The response of SystemApi->get_system_info:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling SystemApi->get_system_info: %s\n" % e)

Parameters

This endpoint does not need any parameter.

Return type

SystemInfoResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Server build metadata-
500Internal server error-

↑ Back to Python SDK

initialize_system

SystemInitResponse initialize_system(body=body)

Initialize the system

Initializes the system by creating a root user and API key. This endpoint should only be called once during first-time setup. If the system is already initialized, the endpoint will return a success response without creating new credentials.

Example

import goodmem_client
from goodmem_client.models.system_init_response import SystemInitResponse
from goodmem_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8080/v1/default
# See configuration.py for a list of all supported configuration parameters.
configuration = goodmem_client.Configuration(
    host = "http://localhost:8080/v1/default"
)

# Enter a context with an instance of the API client
with goodmem_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = goodmem_client.SystemApi(api_client)
    body = None # object | Empty request body - no parameters required (optional)

    try:
        # Initialize the system
        api_response = api_instance.initialize_system(body=body)
        print("The response of SystemApi->initialize_system:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling SystemApi->initialize_system: %s\n" % e)

Parameters

NameTypeDescriptionNotes
bodyobjectEmpty request body - no parameters required[optional]

Return type

SystemInitResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200System initialization successful-
500Internal server error during initialization-

↑ Back to Python SDK