Supported APIs
This version indicates the version of Consul API that is fully supported. Recent versions may still work, but with some missing features.
โ supported ยท ๐ง in progress ยท โ not supported
| Group | Endpoint | Route | Status |
|---|---|---|---|
| Admin Partition | Create a Partition | PUT v1/partition | ๐ง |
| Read a Partition | GET v1/partition/:name | โ | |
| Update a Partition | PUT v1/partition/:name | โ | |
| Delete a Partition | DELETE v1/partition/:name | โ | |
| List all Partitions | GET v1/partitions | โ | |
| Agent | Retrieve host information | GET v1/agent/host | โ |
| List Members | GET v1/agent/members | โ | |
| Read Configuration | GET v1/agent/self | โ | |
| Reload Agent | PUT v1/agent/reload | โ | |
| Enable Maintenance Mode | PUT v1/agent/maintenance | โ | |
| View Metrics | GET v1/agent/metrics | โ | |
| Stream Logs | GET v1/agent/monitor | โ | |
| Join Agent | PUT v1/agent/join/:address | โ | |
| Graceful Leave and Shutdown | PUT v1/agent/leave | โ | |
| Force Leave and Shutdown | PUT v1/agent/force-leave/:node | โ | |
| Agent-Checks | List Checks | GET v1/agent/checks | โ |
| Register Check | PUT v1/agent/check/register | โ | |
| Deregister Check | PUT v1/agent/check/deregister/:check_id | โ | |
| TTL Check Pass | PUT v1/agent/check/pass/:check_id | โ | |
| TTL Check Warn | PUT v1/agent/check/warn/:check_id | โ | |
| TTL Check Fail | PUT v1/agent/check/fail/:check_id | โ | |
| TTL Check Update | PUT /agent/check/update/:check_id | โ | |
| Agent-Services | List Services | GET v1/agent/services | โ |
| Get Service Configuration | GET v1/agent/service/:service_id | โ | |
| Get local service health | GET v1/agent/health/service/name/:service_name | โ | |
| Get local service health by ID | GET v1/agent/health/service/id/:service_id | โ | |
| Register Service | PUT v1/agent/service/register | โ | |
| Deregister Service | PUT v1/agent/service/deregister/:service_id | โ | |
| Enable Maintenance Mode | PUT v1/agent/service/maintenance/:service_id | โ | |
| Connect | Authorize | POST v1/agent/connect/authorize | โ |
| Certificate Authority (CA) Roots | GET v1/agent/connect/ca/roots | โ | |
| Service Leaf Certificate | GET v1/agent/connect/ca/leaf/:service | โ | |
| Catalog | Register Entity | PUT v1/catalog/register | โ |
| Deregister Entity | PUT v1/catalog/deregister | โ | |
| List Datacenters | GET v1/catalog/datacenters | โ | |
| List Nodes | GET v1/catalog/nodes | โ | |
| List Services | GET v1/catalog/services | โ | |
| List Nodes for Service | GET v1/catalog/service/:service | โ | |
| Retrieve Map of Services for a Node | GET v1/catalog/node/:node | โ | |
| List Services for Node | GET v1/catalog/node-services/:node | โ | |
| List Services for Gateway | GET v1/catalog/gateway-services/:gateway | โ | |
| Config | Apply Configuration | PUT v1/config | โ |
| Get Configuration | GET v1/config/:kind/:name | โ | |
| List Configurations | GET v1/config/:kind/:name | โ | |
| Delete Configuration | DELETE v1/config/:kind/:name | โ | |
| Connect | List CA Root Certificates | GET v1/connect/ca/roots | โ |
| Get CA Configuration | GET v1/connect/ca/configuration | ๐ง | |
| Update CA Configuration | PUT v1/connect/ca/configuration | โ | |
| Upsert Intention by Name | PUT v1/connect/intentions/exact | โ | |
| Create Intention with ID | POST v1/connect/intentions | โ | |
| Update Intention by ID | PUT v1/connect/intentions/:uuid | โ | |
| Read Specific Intention by Name | GET v1/connect/intentions/exact | โ | |
| Read Specific Intention by ID | GET v1/connect/intentions/:uuid | โ | |
| List Intentions | GET v1/connect/intentions | โ | |
| Delete Intention by Name | DELETE v1/connect/intentions/exact | โ | |
| Delete Intention by ID | DELETE v1/connect/intentions/:uuid | โ | |
| Check Intention Result | GET v1/connect/intentions/check | โ | |
| List Matching Intentions | GET v1/connect/intentions/match | โ | |
| Coordinate | Read WAN Coordinates | GET v1/coordinate/datacenters | โ |
| Read LAN Coordinates for all nodes | GET v1/coordinate/nodes | โ | |
| Read LAN Coordinates for a node | GET v1/coordinate/node/:node | โ | |
| Update LAN Coordinates for a node | PUT v1/coordinate/update | โ | |
| Discovery Chain | Read Compiled Discovery Chain | GET v1/discovery-chain/:service | โ |
| POST v1/discovery-chain/:service | POST v1/discovery-chain/:service | โ | |
| Events | Fire Event | PUT v1/event/fire/:name | โ |
| List Events | GET v1/event/list | โ | |
| Health | List Checks for Node | GET v1/health/node/:node | โ |
| List Checks for Service | GET v1/health/checks/:service | โ | |
| List Nodes for Service | GET v1/health/service/:service | โ | |
| List Nodes for Connect-capable Service | GET v1/health/connect/:service | โ | |
| List Nodes for Ingress Gateways Associated to a Service | GET v1/health/ingress/:service | โ | |
| List Checks in State | GET v1/health/state/:state | โ | |
| KV Store | Read Key | GET v1/kv/:key | โ |
| Create/Update Key | PUT v1/kv/:key | โ | |
| Delete Key | DELETE v1/kv/:key | โ | |
| Operator-Area | Create Network Area | POST v1/operator/area | โ |
| List Network Areas | GET v1/operator/area | โ | |
| Update Network Area | PUT v1/operator/area/:uuid | โ | |
| List Specific Network Area | GET v1/operator/area/:uuid | โ | |
| Delete Network Area | DELETE v1/operator/area/:uuid | โ | |
| Join Network Area | PUT v1/operator/area/:uuid/join | ๐ง | |
| List Network Area Members | GET v1/operator/area/:uuid/members | โ | |
| Autopilot Operator | Read Configuration | GET v1/operator/autopilot/configuration | โ |
| Update Configuration | PUT v1/operator/autopilot/configuration | โ | |
| Read Health | GET v1/operator/autopilot/health | โ | |
| Read the Autopilot State | GET v1/operator/autopilot/state | โ | |
| Keyring Operator | List Gossip Encryption Keys | GET v1/operator/keyring | โ |
| Add New Gossip Encryption Key | POST v1/operator/keyring | โ | |
| Change Primary Gossip Encryption Key | PUT v1/operator/keyring | โ | |
| Delete Gossip Encryption Key | DELETE v1/operator/keyring | โ | |
| License - Operator | Getting the Consul License | GET v1/operator/license | โ |
| Updating the Consul License | PUT v1/operator/license | ๐ (Deprecated in 1.10.0) | |
| Resetting the Consul License | DELETE v1/operator/license | ๐ (Deprecated in 1.10.0) | |
| Raft Operator | Read Configuration | GET v1/operator/raft/configuration | โ |
| Delete Raft Peer | DELETE v1/operator/raft/peer | โ | |
| Network Segments - Operator | List Network Segments | GET v1/operator/segment | โ |
| Namespace | Create a Namespace | PUT v1/namespace | โ |
| Read a Namespace | GET v1/namespace/:name | โ | |
| Update a Namespace | PUT v1/namespace/:name | โ | |
| Delete a Namespace | DELETE v1/namespace/:name | โ | |
| List all Namespaces | GET v1/namespaces | โ | |
| Prepared Query | Create Prepared Query | POST v1/query | โ |
| List Prepared Queries | GET v1/query | โ | |
| Update Prepared Query | PUT v1/query/:uuid | โ | |
| Read Prepared Query | GET v1/query/:uuid | โ | |
| Delete Prepared Query | DELETE v1/query/:uuid | โ | |
| Execute Prepared Query | GET v1/query/:uuid/execute | โ | |
| Explain Prepared Query | GET v1/query/:uuid/explain | โ | |
| Session | Create Session | PUT v1/session/create | โ |
| Delete Session | PUT v1/session/destroy/:uuid | โ | |
| Read Session | GET v1/session/info/:uuid | โ | |
| List Sessions for Node | GET v1/session/node/:node | โ | |
| List Sessions | GET v1/session/list | โ | |
| Renew Session | PUT v1/session/renew/:uuid | โ | |
| Snapshot | Generate Snapshot | GET v1/snapshot | โ |
| Restore Snapshot | PUT v1/snapshot | โ | |
| Status | Get Raft Leader | GET v1/status/leader | โ |
| List Raft Peers | GET v1/status/peers | โ | |
| Transactions | Create Transaction | PUT v1/txn | โ |