Managing Stacks via API

Automate stack management using the Logit.io Developer API. This guide covers listing stacks, retrieving connection details, and requesting upgrades.

Use your Dashboard API key from the Profile (opens in a new tab) page in the x-api-key header. See Authentication for setup and security. For stack-specific endpoints, use @logs_id, @metrics_id, or @apm_id depending on which stack you're managing (from your session/JWT when signed in).

List Your Stacks

First, get your account ID from /api/accounts, then fetch stacks for that account.

Get accounts

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/accounts

Get stacks for an account

Replace ACCOUNT_ID with your account ID from the response above.

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/account/ACCOUNT_ID/stacks

The response returns subscriptions and their associated stacks, including stack IDs and product names.

Get Stack Overview

Retrieve overview information for a specific stack. Use @logs_id, @metrics_id, or @apm_id for the stack you're viewing.

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/stacks/@logs_id

The response includes stack name, type, and status.

Get Connection Details

Fetch connection URLs and service information (e.g. Logstash endpoints, OpenSearch URLs) for a stack:

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/stacks/@logs_id/connection-details

Use this to programmatically configure shippers or clients that send data to your stack.

Get Getting-Started Info

Check whether a stack has received data and retrieve getting-started guidance:

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/stacks/@logs_id/getting-started

Get Stack Statistics

Retrieve usage statistics (volume sent, plan limits) for a stack:

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/stacks/@logs_id/statistics

Request a Stack Upgrade

For Log Management stacks, you can check available versions and request upgrades.

Check upgrade options

curl -H "x-api-key: @dashboardApiKey" https://dashboard.logit.io/api/stacks/@logs_id/upgrade

Request upgrade

POST with versionId in the body (from the check upgrade response).

curl -X POST -H "x-api-key: @dashboardApiKey" -H "Content-Type: application/json" \
  -d '{"versionId": "VERSION_ID"}' \
  https://dashboard.logit.io/api/stacks/@logs_id/upgrade/requests

For more on upgrades, see Migrate or Upgrade Your Stack.

Audit Log

Search the audit log for stack activity:

curl -H "x-api-key: @dashboardApiKey" "https://dashboard.logit.io/api/stacks/@logs_id/audit-log?Page=1&PageSize=20"

Optional query parameters: Search, Period.

Full API Reference

See the API Reference for complete endpoint documentation, request/response schemas, and additional stack operations.