GET/api/installs/lookup-by-host

Lookup extension install by runner host

Internal endpoint for extension runners. Given a runner domain, resolves the tenant, extension registry ID, and current bundle content hash needed to serve extension content. The EE implementation queries tenant_extension_install.runner_domain with an admin connection and then selects the latest extension_bundle row for the installed version. In non-EE builds the product-extension action is a stub. Requires x-api-key; the Express middleware allows the ALGA_AUTH_KEY runner secret or a valid database API key.

Query parameters

hoststringRequired

Runner domain hostname to resolve. The implementation lowercases the value and strips any port before matching tenant_extension_install.runner_domain.

Header parameters

x-canarystringOptional

Optional runner canary identifier used only for logging and cache variance.

Response body

Success response 200 · schema InstallLookupByHostResponse

tenant_idstringRequired

Tenant ID from tenant_extension_install.tenant_id for the matching runner domain.

extension_idstring <uuid>Required

Extension registry UUID from tenant_extension_install.registry_id.

content_hashstringRequired

Content hash from extension_bundle.content_hash for the install version. Usually sha256:<64 hex chars>.

Response codes

200

Install mapping found for the runner host.

400

The required host query parameter is missing.

401

x-api-key is missing or invalid at middleware.

404

No install or bundle was found for the runner host.

500

Unexpected lookup failure.

GET /api/installs/lookup-by-host

cURL

curl -X GET "https://algapsa.com/api/installs/lookup-by-host?host=x" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "x-canary: string"

TypeScript

const response = await fetch("https://algapsa.com/api/installs/lookup-by-host?host=x", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "x-canary": "string",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/installs/lookup-by-host?host=x");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("x-canary", "string");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "tenant_id": "string",
  "extension_id": "01HN2K7VRB9PQ3Y0000000000",
  "content_hash": "string"
}