# Kong Upstreams API

**Canonical:** https://apis.io/apis/kong/kong-upstreams-api/  
**Provider:** Kong — https://apis.io/providers/kong/  
**Base URL:** https://konghq.com/  
**Documentation:** https://konghq.com/products/kong-gateway

Kong Upstreams API is one of 139 APIs that [Kong](https://apis.io/providers/kong/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Upstreams. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, a GitHub repository, an API reference, authentication docs, and 1 JSON Schema.

The upstream object represents a virtual hostname and can be used to load balance incoming requests over multiple services (targets). <br><br> An upstream also includes a [health checker](https://developer.konghq.com/gateway/traffic-control/health-checks-circuit-breakers/), which can enable and disable targets based on their ability or inability to serve requests. The configuration for the health checker is stored in the upstream object, and applies to all of its targets.

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/openapi/kong-upstreams-api-openapi.yml
- **Documentation** — https://developer.konghq.com/api/gateway/admin-ee/3.14/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/json-schema/kong-service-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/kong/refs/heads/main/json-ld/kong-context.jsonld
- **GitHubRepository** — https://github.com/Kong/kong
- **Documentation** — https://developer.konghq.com/api/
- **APIReference** — https://developer.konghq.com/api/
- **Authentication** — https://developer.konghq.com/konnect-platform/personal-access-tokens/
- **SDKs** — https://github.com/Kong/sdk-konnect-go
- **Documentation** — https://developer.konghq.com/event-gateway/

## Other Kong APIs (12)

- [Kong Gateway](https://apis.io/apis/kong/kong/)
- [Kong AI Gateway](https://apis.io/apis/kong/kong-ai-gateway/)
- [Kong Agent Gateway](https://apis.io/apis/kong/kong-agent-gateway/)
- [Kong MCP Registry](https://apis.io/apis/kong/kong-mcp-registry/)
- [Kong Context Mesh](https://apis.io/apis/kong/kong-context-mesh/)
- [Kong Mesh](https://apis.io/apis/kong/kong-mesh/)
- [Kong Insomnia](https://apis.io/apis/kong/kong-insomnia/)
- [Kong ACLs API](https://apis.io/apis/kong/kong-acls-api/)
- [Kong Add-Ons API](https://apis.io/apis/kong/kong-add-ons-api/)
- [Kong API API](https://apis.io/apis/kong/kong-api-api/)
- [Kong API Attributes API](https://apis.io/apis/kong/kong-api-attributes-api/)
- [Kong API Documentation API](https://apis.io/apis/kong/kong-api-documentation-api/)

## Tags

Upstreams

---

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