HashiCorp Consul

aid: consul
name: HashiCorp Consul
url: https://raw.githubusercontent.com/api-evangelist/consul/refs/heads/main/apis.yml
description: >-
  HashiCorp Consul is a distributed, highly available service-networking control plane that automates network
  configuration, discovers services, enables secure service-to-service communication, and exposes a strongly consistent
  key/value store. The Consul HTTP API is a REST + JSON service exposed by every Consul agent and server at /v1, gated
  by the X-Consul-Token header (apiKey) and ACL policies, supporting blocking queries via X-Consul-Index for
  streaming-style change detection.
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
tags:
  - ACL
  - Configuration
  - Health Checking
  - Key/Value Store
  - Multi-Datacenter
  - Open Source
  - Service Discovery
  - Service Mesh
created: '2024-01-01'
modified: '2026-05-19'
position: Provider
specificationVersion: '0.19'
kind: opensource
apis:
  - aid: consul:http-api
    name: Consul HTTP API
    description: >-
      The main HTTP API for interacting with Consul agents and servers. Endpoints are grouped under /agent (local agent
      state and registration), /catalog (cluster-wide service and node catalog), /health (health-checked service
      queries), /kv (key/value store), /acl (token, policy, and role management), /connect (service mesh CA,
      intentions), /config (central configuration entries), /event (user events), /session (locks and leadership), and
      /operator (Raft, autopilot, license).
    image: https://www.consul.io/img/logo-hashicorp.svg
    humanURL: https://developer.hashicorp.com/consul/api-docs
    baseURL: http://localhost:8500/v1
    tags:
      - ACL
      - Catalog
      - Connect
      - Health
      - Key/Value
      - Service Discovery
      - Service Mesh
    properties:
      - type: Documentation
        url: https://developer.hashicorp.com/consul/api-docs
      - type: OpenAPI
        url: openapi/consul-http-api.yml
      - type: Authentication
        url: https://developer.hashicorp.com/consul/api-docs/api-structure
      - type: ACL Documentation
        url: https://developer.hashicorp.com/consul/docs/security/acl
      - type: GitHubRepository
        url: https://github.com/hashicorp/consul
common:
  - type: Website
    url: https://www.consul.io
  - type: Documentation
    url: https://developer.hashicorp.com/consul
  - type: GettingStarted
    url: https://developer.hashicorp.com/consul/tutorials/get-started-vms
  - type: Tutorials
    url: https://developer.hashicorp.com/consul/tutorials
  - type: GitHubOrganization
    url: https://github.com/hashicorp
  - type: GitHubRepository
    url: https://github.com/hashicorp/consul
  - type: ChangeLog
    url: https://github.com/hashicorp/consul/releases
  - type: Blog
    url: https://www.hashicorp.com/blog/products/consul
  - type: Community
    url: https://discuss.hashicorp.com/c/consul
  - type: Twitter
    url: https://twitter.com/HashiCorp
  - type: TermsOfService
    url: https://www.hashicorp.com/terms-of-service
  - type: PrivacyPolicy
    url: https://www.hashicorp.com/privacy
  - type: JSONLD
    url: json-ld/consul-context.jsonld
  - type: JSONSchema
    url: json-schema/consul-service-schema.json
  - type: JSONSchema
    url: json-schema/consul-kv-schema.json
  - type: Spectral
    url: rules/consul-rules.yml
maintainers:
  - FN: Kin Lane
    email: [email protected]