Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Instana Custom Dashboards API

You can use these API endpoints to manage custom dashboards. We recommendthat you leverage the `Edit as JSON` feature found within our user interfaceto construct the desired request payloads. Specifically to help you buildcorrect widget configurations and access rules.To identify the correct values for the `relatedId` field of the access rules,we recommend using the `/api/custom-dashboard/shareable-users` and`/api/custom-dashboard/shareable-api-tokens` endpoints. These endpoints returnour internal IDs for users and API tokens.

Instana Custom Dashboards API is one of 62 APIs that Instana publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Custom Dashboards. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.0.1, at version 1.307.1417.

Requests are made against 2 base URLs: https://{unit}-{tenant}.instana.io, https://{domain}.

7 operations 4 paths 7 schemas 1 DELETE4 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.307.1417
Servers
https://{unit}-{tenant}.instana.io
https://{domain}
Authentication
API Key
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Instana Custom Dashboards API declares 1 security scheme for authenticating requests. An API key is passed in the header as authorization (ApiKeyAuth).

  • ApiKeyAuth — Example bash curl --request GET \ --url https://test-instana.instana.io/api/application-monitoring/catalog/metrics \ --header 'authorization: apiToken xxxxxxxx…

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Custom Dashboards 7

You can use these API endpoints to manage custom dashboards. We recommend that you leverage the Edit as JSON feature found within our user interface to construct the desired reque…

GET
/api/custom-dashboard
Get accessible custom dashboards
getCustomDashboards 4 params → 200
POST
/api/custom-dashboard
Add custom dashboard
addCustomDashboard body → 200403422
GET
/api/custom-dashboard/shareable-api-tokens
Get all API tokens.
getShareableApiTokens → 200
GET
/api/custom-dashboard/shareable-users
Get all users (without invitations).
getShareableUsers → 200
DELETE
/api/custom-dashboard/{customDashboardId}
Remove custom dashboard
deleteCustomDashboard 1 param → 204
GET
/api/custom-dashboard/{customDashboardId}
Get custom dashboard
getCustomDashboard 1 param → 200
PUT
/api/custom-dashboard/{customDashboardId}
Update custom dashboard
updateCustomDashboard 1 param body → 200403422

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Widget (8 properties), CustomDashboardWithUserSpecificInformation (6 properties), CustomDashboardPreview (4 properties), CustomDashboard (4 properties). Each schema is shown below with its type and property counts.

CustomDashboardWithUserSpecificInformation
object
6 properties 6 required
Widget
object
8 properties 3 required
CustomDashboard
object
4 properties 4 required
UserBasicResult
object
3 properties 3 required
AccessRule
object
3 properties 2 required
DashboardApiToken
object
2 properties 2 required
CustomDashboardPreview
object
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

instana-custom-dashboards-api-openapi.yml Raw ↑

Other APIs Instana publishes across the network.

Instana Action Catalog API
Instana Action History API
Instana AI Management API
Instana Apdex Report API
Instana Apdex Settings API
Instana API Token API
Instana Application Alert Configuration API
Instana Application Analyze API
Instana Application Catalog API
Instana Application Metrics API
Instana Application Resources API
Instana Application Settings API