Connect to Your Cluster

Connect directly to your OpenSearch cluster

Call the full OpenSearch REST API on your stack to search and index documents, manage indexes and templates, check cluster health, run reindex jobs, and anything else in the OpenSearch API reference (opens in a new tab).

Logit.io supports two authentication modes: API key (default) and Basic (username and password).

When signed in, examples auto-fill @opensearch.endpointAddress, @opensearch.apiKey, @opensearch.username, and @opensearch.password from Settings → Endpoints (Logs and OpenSearch stacks).

Which stack type do you have?

Logs stackOpenSearch stack
ProductLog management (Logstash + OpenSearch + Dashboards)Dedicated OpenSearch cluster
Dashboard pathStack → SettingsEndpointsStack → SettingsEndpoints
Also on stack summaryOpenSearch section → View Full DetailsStack summary (show password)
Product-specific docsLog Management overviewOpenSearch product overview

How to find your connection details

  1. Sign in to your Logit.io account.
  2. Open Settings for the stack you want to access.
  3. Select Endpoints from the menu.
  4. In OpenSearch API Details, copy your endpoint, credentials, and preferred port.

The Endpoints page shows:

FieldDescription
Authentication ModeAPI Key or Basic (Username and Password). Stack administrators can switch modes from this page.
Endpointhttps://{stack-id}-es.logit.io
API KeyShown in API key mode. Append as the apikey query parameter on requests.
Username / PasswordShown in Basic mode. Username is your stack ID; password is your stack API key.
Available Ports9200 (SSL default port) or 443 (SSL TCP port). Both use HTTPS.

The page also provides Example Authenticated API Access URLs with your credentials embedded.

OpenSearch API details on the Endpoints page

Base URL and ports

@opensearch.endpointAddress

Append the OpenSearch API path (for example /_cluster/health, /_search, or /my-index/_doc) to that URL.

Ports: 443 (common for HTTPS clients) or 9200 (OpenSearch default SSL port).

Using any OpenSearch API endpoint

OperationHTTP methodPath
Cluster healthGET/_cluster/health
List indexesGET/_cat/indices?v
SearchGET or POST/_search or /{index}/_search
Index a documentPOST/{index}/_doc
Bulk ingestPOST/_bulk
Get index templatesGET/_index_template or /_template
ReindexPOST/_reindex

See API Overview for Logit guides by API family.

Using API key authentication mode

Pass your stack API key as the apikey query parameter on every request.

curl -X GET "@opensearch.endpointAddress:443/_cluster/health?apikey=@opensearch.apiKey&pretty"

Using Basic (username and password) authentication mode

Username = stack ID, password = stack API key. Example authenticated URL from the Endpoints page:

https://@opensearch.username:@opensearch.password@@opensearch_id-es.logit.io:443
curl -X GET "@opensearch.endpointAddress:443/_cluster/health?pretty" \
  -u "@opensearch.username:@opensearch.password"

Switching authentication mode

Switch between API Key and Basic on the Endpoints page (~30 seconds to apply). Use Basic for clients that expect user and password (for example Logstash elasticsearch output or Serilog).

Next steps