API Connect

API Connect is RAGA's HTTP proxy service, built on Node.js + Express. It accepts API connection and endpoint configuration via the request body, handles authentication (Basic, Bearer, or JWT auto-login), then forwards the request to the external API and returns its response as-is.

API Connect is called by API Tarantula to execute calls for the Text-to-API feature — LLM-generated requests are forwarded through this service to an external API configured by the user at the workspace level, without storing that API's credentials anywhere on the server.

API Connect is stateless — no API configuration is stored in this service. All credentials and endpoint details are sent by the caller inside the request body every time.

Tech Stack

Component	Technology
Runtime	Node.js 18
Framework	Express 4
HTTP Client	axios
API Docs	swagger-ui-express + swagger-jsdoc (/api-docs)

Full endpoint, authentication mode, and flow diagram details are on the Technical page.

How It Works

1. The caller sends POST /proxy with a connection object containing the target host, auth, and endpoint (path, method, params/body).
2. API Connect prepares the authentication header based on auth.type: Basic (base64 user:password), Bearer (token used directly), or JWT (auto-login to loginPath to fetch a token first).
3. The request is forwarded to the external API via axios according to the HTTP method (GET/HEAD use query params, other methods use the body).
4. The response from the target API is passed through as-is to the caller.

Summary

API Connect is a thin, stateless bridge between the RAGA engine and whichever external API a user has configured — similar in role to Database Connect for RDBMS, but for Text-to-API: it handles authentication complexity (including JWT auto-login) so external API configuration stays flexible per workspace without hardcoding anything server-side.