Instill AI · OpenAPI Overlay 1.0.0

Instill Core API: API Evangelist enhancements

5 actions 5 updates update extends ../openapi/_original/instill-ai-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Instill AI's API. It is a proposal applied on top of the contract, not a document Instill AI publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-serverx-llms-txtx-documentationx-key-prefixx-header-formatx-long-runningx-poll-operationx-streaming

Targets 5

$.info

$.securityDefinitions.Bearer

$.paths.*.*[?(@.operationId == "PipelinePublicService_TriggerAsyncPipeline" || @.operationId == "PipelinePublicService_TriggerAsyncPipelineRelease" || @.operationId == "ModelPublicService_TriggerAsyncModel" || @.operationId == "ModelPublicService_TriggerAsyncModelVersion")]

$.paths.*.*[?(@.operationId == "PipelinePublicService_TriggerPipelineWithStream")]

$.paths.*.*[?(@.operationId == "PipelinePublicService_ListPublicPipelines" || @.operationId == "PipelinePublicService_ListPipelines" || @.operationId == "ModelPublicService_ListModels" || @.operationId == "ArtifactPublicService_ListKnowledgeBases" || @.operationId == "ArtifactPublicService_ListFiles")]

OpenAPI Overlay

overlay: 1.0.0
info:
  title: 'Instill Core API: API Evangelist enhancements'
  version: 1.0.0
extends: ../openapi/_original/instill-ai-openapi.yml
x-generated: '2026-10-09'
x-method: generated
actions:
- target: $.info
  description: Point agents at the agent surfaces
  update:
    x-mcp-server: https://docs.instill-ai.com/mcp
    x-llms-txt: https://docs.instill-ai.com/llms.txt
    x-documentation: https://docs.instill-ai.com/reference
- target: $.securityDefinitions.Bearer
  description: Clarify the key format (taken from the spec's own description)
  update:
    x-key-prefix: instill_sk_
    x-header-format: Bearer instill_sk_***
- target: $.paths.*.*[?(@.operationId == "PipelinePublicService_TriggerAsyncPipeline" || @.operationId == "PipelinePublicService_TriggerAsyncPipelineRelease"
    || @.operationId == "ModelPublicService_TriggerAsyncModel" || @.operationId == "ModelPublicService_TriggerAsyncModelVersion")]
  description: Mark async triggers as long-running operations
  update:
    x-long-running: true
    x-poll-operation: PipelinePublicService_GetOperation / ModelPublicService_GetOperation
- target: $.paths.*.*[?(@.operationId == "PipelinePublicService_TriggerPipelineWithStream")]
  description: Streaming trigger
  update:
    x-streaming: true
- target: $.paths.*.*[?(@.operationId == "PipelinePublicService_ListPublicPipelines" || @.operationId == "PipelinePublicService_ListPipelines"
    || @.operationId == "ModelPublicService_ListModels" || @.operationId == "ArtifactPublicService_ListKnowledgeBases" || @.operationId == "ArtifactPublicService_ListFiles")]
  description: Read-only list operations, safe for agent retries
  update:
    x-agent-safe: true

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/instill-ai-openapi-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?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.