---
type: api
title: Elastic Cloud Connected API
description: This API enables you to use Elastic Cloud services in your ECE, ECK, or self-managed cluster without having to install
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect
products:
  - Elastic Cloud Hosted
---

# Elastic Cloud Connected API

This API enables you to use Elastic Cloud services in your ECE, ECK, or self-managed cluster without having to install
and maintain their infrastructure yourself.

You can create, update, and manage Cloud Connected clusters and their services.

## API principles

The Elastic Cloud Connected REST API is built following REST principles:

* Resources (such as clusters) are represented as URIs.
* Standard HTTP response codes and verbs are used (GET, POST, PUT, PATCH and DELETE).
* API calls are stateless. Every request that you make happens in isolation from other calls and must include all the information necessary to fulfill the request.
* JSON is the data interchange format.

## OpenAPI Specification

The API is documented using the [OpenAPI Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification). The current supported version of the specification is 3.0.
For details, check the [API reference](https://www.elastic.co/docs/api/doc/elastic-cloud-connected/) or download the [OpenAPI Specification](https://www.elastic.co/docs/api/doc/elastic-cloud-connected.yaml).
This specification can be used to generate client SDKs, or on tools that support it, such as the [Swagger Editor](https://editor.swagger.io/).

## Documentation source and versions

This documentation is derived from a private repository.
It is provided under license [Attribution-NonCommercial-NoDerivatives 4.0 International](https://creativecommons.org/licenses/by-nc-nd/4.0/).

- [Authentication](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/authentication)
- [Servers](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/servers)
### [clusters](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/group/endpoint-clusters)

- [Get Cloud Connected clusters](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-listclusters): `GET` `/api/v1/cloud-connected/clusters`
- [Create a Cloud Connected cluster.](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-createcluster): `POST` `/api/v1/cloud-connected/clusters`
- [Get a Cloud Connected cluster](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-getcluster): `GET` `/api/v1/cloud-connected/clusters/{id}`
- [Disconnect a Cloud Connected cluster](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-deletecluster): `DELETE` `/api/v1/cloud-connected/clusters/{id}`
- [Update a Cloud Connected cluster](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-patchcluster): `PATCH` `/api/v1/cloud-connected/clusters/{id}`
### [organizations](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/group/endpoint-organizations)

- [Get subscription state](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-getsubscription): `GET` `/api/v1/cloud-connected/organizations/{organization_id}/subscription`
- [Get acceptance info of terms and conditions](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-gettermsandconditions): `GET` `/api/v1/cloud-connected/organizations/{organization_id}/terms-and-conditions`
- [Accept terms and conditions](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-accepttermsandconditions): `POST` `/api/v1/cloud-connected/organizations/{organization_id}/terms-and-conditions/_accept`
### [rotation of api keys](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/group/endpoint-rotation-of-api-keys)

- [Revoke previously rotated Cluster API Keys](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-revokependingclusterapikeys): `POST` `/api/v1/cloud-connected/clusters/{id}/apikey/_revoke-pending`
- [Rotate the Cloud Connected cluster API Key](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-rotateclusterapikey): `POST` `/api/v1/cloud-connected/clusters/{id}/apikey/_rotate`
- [Revoke previously rotated service API Keys](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-revokependingserviceapikeys): `POST` `/api/v1/cloud-connected/clusters/{id}/apikey/{service}/_revoke-pending`
- [Rotate a Cloud Connected service API Key](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-connect/operation/operation-rotateserviceapikey): `POST` `/api/v1/cloud-connected/clusters/{id}/apikey/{service}/_rotate`