No Methods in OpenAPI Endpoint

Problem

The API project starts successfully, but no methods appear in the OpenAPI endpoint.

How to Diagnose

Check the application console logs.

If you see an error similar to the following:

ERROR i.o.f.utils.source.HubSourceProvider Failed to retrive ${project} from the Hub
  ...
ERROR i.o.f.s.w.openapi.OpenApiHolder Could not finde project metadata, using empty project.

This means the project failed to retrieve its metadata from the OpenLegacy Hub.

Possible Causes and Solutions

1. Network Connectivity Issue

The project may not have connectivity to the OpenLegacy Hub.

Possible checks:

  • Verify the Hub URL configuration.
  • Ensure the environment running the project can reach the Hub over the network.
  • Check firewall, proxy, or VPN restrictions.

2. Invalid or Missing API Key

The API Key used by the project might be invalid, expired, or missing permissions.

Recommended action:

  • Validate the API Key against the Hub using the OpenLegacy CLI.
  • If needed, generate a new API Key and update the project configuration.

3. Metadata Retrieval Timeout

If the project contains a large amount of metadata (for example, modules with many assets or assets with many versions), the request to the Hub may time out.

You can reduce the metadata payload by setting the following environment variable:

OL_HUB_INCLUDE_ALL_ASSETS=false

When this flag is set:

  • The project loads only the assets it uses.
  • This reduces the metadata payload size.
  • By default, this value is true.