GET/api/ext/{extensionId}/{path}

Forward GET request to extension runner

Tenant-scoped extension gateway endpoint that forwards GET requests to an installed extension runner. The gateway resolves the tenant from x-alga-tenant, x-tenant-id, session cookie, or DEV_TENANT_ID in development; verifies the extension is installed and enabled for that tenant; forwards selected headers and all query parameters to RUNNER_BASE_URL /v1/execute; and relays the runner response. GET requests do not read a body and do not generate an idempotency key. The gateway currently has a placeholder access check and does not enforce per-extension RBAC beyond tenant install resolution.

Path parameters

extensionIdstringRequired

Extension identifier from the URL. This may be a registry/install UUID or a publisher.name slug, resolved case-insensitively.

pathstringOptional

Remaining extension endpoint path after extensionId. The gateway forwards this path to the runner unchanged.

Header parameters

x-request-idstring <uuid>Optional

Optional request ID. The gateway generates a UUID when absent and forwards it to the runner.

x-idempotency-keystringOptional

Optional idempotency key for non-GET methods. The gateway falls back to x-request-id when absent and forwards the key to the runner.

x-alga-tenantstringOptional

Internal tenant header used for tenant resolution before session fallback.

x-tenant-idstringOptional

Legacy tenant header accepted for tenant resolution before session fallback.

Response body

Success response 200 · schema ExtensionOpaqueResponse

object

Extension-specific response relayed from the runner. Status code, content type, and body are controlled by the extension.

Response codes

200

Runner response relayed by the gateway. The actual status can vary by extension contract.

204

Runner returned no content, or CORS preflight for OPTIONS requests on this gateway path.

404

Extension is not installed or not enabled for the resolved tenant.

500

Tenant could not be resolved or another internal gateway error occurred.

502

Runner call failed, runner response was empty/invalid, or install context was incomplete.

GET /api/ext/{extensionId}/{path}

cURL

curl -X GET "https://algapsa.com/api/ext/{extensionId}/{path}" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "x-request-id: 01HN2K7VRB9PQ3Y0000000000" \
  -H "x-idempotency-key: string" \
  -H "x-alga-tenant: string" \
  -H "x-tenant-id: string"

TypeScript

const response = await fetch("https://algapsa.com/api/ext/{extensionId}/{path}", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "x-request-id": "01HN2K7VRB9PQ3Y0000000000",
    "x-idempotency-key": "string",
    "x-alga-tenant": "string",
    "x-tenant-id": "string",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/ext/{extensionId}/{path}");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("x-request-id", "01HN2K7VRB9PQ3Y0000000000");
request.Headers.TryAddWithoutValidation("x-idempotency-key", "string");
request.Headers.TryAddWithoutValidation("x-alga-tenant", "string");
request.Headers.TryAddWithoutValidation("x-tenant-id", "string");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{}