# Jentic Overlays API

**Canonical:** https://apis.io/apis/jentic/jentic-overlays-api/  
**Provider:** Jentic — https://apis.io/providers/jentic/  
**Base URL:** https://api.jentic.com/mcp  
**Documentation:** https://docs.jentic.com/guides/mcp/remote-mcp/

Jentic Overlays API is one of 39 APIs that [Jentic](https://apis.io/providers/jentic/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Overlays. The published artifact set on APIs.io includes an OpenAPI specification.

OpenAPI Overlay 1.0 (`https://spec.openapis.org/overlay/v1.0.0`) documents that correct an imported spec without rewriting it. Overlays capture wrong required fields, missing security schemes, undocumented headers, silent payload truncation, and other places where the upstream spec disagrees with the upstream API's actual behaviour — without forking the spec or waiting for an upstream fix. Overlays attach to the `Api` aggregate (not to a specific `ApiRevision`) and continue to apply across revision bumps until materially superseded. The optional `target_revision_id` records the revision the overlay was authored against, for auditing. **Lifecycle.** New overlays start in `pending`. The Broker calls `POST /apis/{vendor}/{name}/{version}/overlays/{overlay_id}:confirm` after the first successful upstream execution that exercised an overlay-patched operation, transitioning the overlay to `confirmed`. This is the platform's only documented data-plane → control-plane writeback. Once `confirmed`, an overlay stays `confirmed` — repeated `:confirm` calls return `200` with the existing record unchanged. **Edit model.** Overlay documents are editable via `PATCH` only while `pending`. Once `confirmed` (or `deprecated`), the document is immutable — to change a confirmed overlay, submit a new one and let the old one age out via `DELETE` (which soft-deprecates). **Deletion.** `DELETE` is a **soft-deprecation** — the row is preserved with `status: deprecated` for audit. Deprecated overlays no longer apply to spec-download merges (`?overlays=false` becomes the default for that overlay) but stay queryable via `GET`. There is no hard-delete in this surface. **Authentication.** Any authenticated principal (agent or human) can submit, edit, confirm, or deprecate overlays. Platform-side rate limits gate abuse.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/apis/{vendor}/{name}/{version}/overlays` | List Overlays |
| POST | `/apis/{vendor}/{name}/{version}/overlays` | Submit Overlay |
| DELETE | `/apis/{vendor}/{name}/{version}/overlays/{overlay_id}` | Deprecate Overlay |
| GET | `/apis/{vendor}/{name}/{version}/overlays/{overlay_id}` | Get Overlay |
| PATCH | `/apis/{vendor}/{name}/{version}/overlays/{overlay_id}` | Update Overlay |
| POST | `/apis/{vendor}/{name}/{version}/overlays/{overlay_id}:confirm` | Confirm Overlay |
| POST | `/apis/{vendor}/{name}/{version}/overlays/{overlay_id}:rollback` | Rollback Overlay |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/jentic/openapi/jentic-overlays-api-openapi.yml

## Other Jentic APIs (12)

- [Jentic Remote MCP Server](https://apis.io/apis/jentic/jentic-mcp/)
- [Arazzo Engine](https://apis.io/apis/jentic/arazzo-engine/)
- [Jentic Standard Agent](https://apis.io/apis/jentic/standard-agent/)
- [Jentic Mini](https://apis.io/apis/jentic/jentic-mini/)
- [Jentic API AI-Readiness Framework (JAIRF)](https://apis.io/apis/jentic/jairf/)
- [Jentic Authentication API](https://apis.io/apis/jentic/jentic-authentication-api/)
- [Jentic Execution API](https://apis.io/apis/jentic/jentic-execution-api/)
- [Jentic Search API](https://apis.io/apis/jentic/jentic-search-api/)
- [Jentic Access Requests API](https://apis.io/apis/jentic/jentic-access-requests-api/)
- [Jentic Actors API](https://apis.io/apis/jentic/jentic-actors-api/)
- [Jentic Agent Registration API](https://apis.io/apis/jentic/jentic-agent-registration-api/)
- [Jentic Agents API](https://apis.io/apis/jentic/jentic-agents-api/)

## Tags

Overlays

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/jentic/jentic-overlays-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/jentic/.