DoiT

DoiT Insights API

Manage cloud insights representing recommendations and findings for cloud resources.

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /insights/v1/results List optimization insights · List insights #
Ask an LLM
“What cost savings opportunities has DoiT found for us?”
“Can I filter insights to only easy wins or by cloud provider?”
Tell an agent
List insights in category {category}.
Show insights with priority {priority} for {cloudProvider}.
POST /insights/v1/results Create or update insights in bulk · Create insights (batch) #
Ask an LLM
“Can I push many custom insights in a single request?”
“How do I upload my own optimization findings in batch?”
Tell an agent
Upload insights batch {results}.
Create or update these insights in bulk: {results}.
DELETE /insights/v1/results Delete insights by key in bulk · Delete insights (batch) #
Ask an LLM
“How do I remove every insight with a given key from my batch source?”
“Does bulk deleting also remove resource results?”
Tell an agent destructive · confirm first
Delete all insights with key {insightKey}.
Bulk remove insights keyed {insightKey} and their resource results.
GET /insights/v1/results/source/{sourceID}/insight/{insightKey} Retrieve one insight summary · Retrieve an insight #
Ask an LLM
“How do I see the savings summary for a single insight?”
“Does fetching one insight include its resource-level results?”
Tell an agent
Get insight {insightKey} from source {sourceID}.
Show the summary of insight {insightKey} in {sourceID}.
POST /insights/v1/results/source/{sourceID}/insight/{insightKey} Create or update a single insight · Create or update an insight #
Ask an LLM
“How do I publish one custom insight for a source?”
“What happens if an insight with the same key already exists?”
Tell an agent
Upsert insight {key} titled {title} in source {sourceID} under key {insightKey} for {cloudProvider}, categories {categories}: {shortDescription}.
Save insight {insightKey} for source {sourceID} with title {title}.
DELETE /insights/v1/results/source/{sourceID}/insight/{insightKey} Delete a single insight · Delete an insight #
Ask an LLM
“How do I permanently delete one insight I created via the API?”
“Can I delete insights that weren't created through the public API?”
Tell an agent destructive · confirm first
Delete insight {insightKey} from source {sourceID}.
Permanently remove insight {insightKey} in {sourceID}.
PUT /insights/v1/results/source/{sourceID}/insight/{insightKey}/status Acknowledge or dismiss an insight · Update Insight Status #
Ask an LLM
“How do I mark an insight as acknowledged or dismissed?”
“Can I record why I dismissed an insight?”
Tell an agent
Set insight {insightKey} in {sourceID} to {status}.
Dismiss insight {insightKey} from {sourceID} with status {status} and details {dismissalDetails}.
GET /insights/v1/results/source/{sourceID}/insight/{insightKey}/resource-results List affected resources for an insight · List resource results for an insight #
Ask an LLM
“Which individual cloud resources does an insight apply to?”
“Can I page through an insight's resource-level results?”
Tell an agent
List resource results for insight {insightKey} in {sourceID}.
Show the affected resources of insight {insightKey} from {sourceID}.
POST /insights/v1/results/source/{sourceID}/insight/{insightKey}/resource-results Replace an insight's resource results · Replace resource results for an insight #
Ask an LLM
“How do I overwrite the list of resources attached to an insight?”
“What happens to existing resource results not in my new set?”
Tell an agent
Replace resource results of insight {insightKey} in {sourceID} with {resourceResults}.
Overwrite affected resources on {insightKey} for source {sourceID}: {resourceResults}.

Documentation

📖
Documentation
https://developer.doit.com/docs/start
📖
APIReference
https://developer.doit.com/reference/welcome
📖
GettingStarted
https://developer.doit.com/docs/start
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/authentication/doit-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/rate-limits/doit-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/openapi/doit-insights-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/scopes/doit-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/errors/doit-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/data-model/doit-data-model.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/conventions/doit-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doit:doit-insights-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doit-insights-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DoiT Insights API
  description: Programmatic access to DoiT Platform
  version: v1
servers:
- url: https://api.doit.com
security:
- api_key: []
- tenantId: []
  api_key: []
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/doit/refs/heads/main/openapi/doit-insights-api-openapi.yml