Home / Keptn v1 Docs / Release 0.10.0 / Reference / Keptn API
In this section, the functionality and commands of the Keptn REST API are described.
To access the Keptn API, a running Keptn installation is needed. If you have not set up Keptn yet, please start here.
To get the API token for authenticating API calls, please see here.
The Keptn API is documented in terms of a Swagger API documentation.
Use the Keptn CLI to retrieve the endpoint of your Keptn API via the command keptn status
:
keptn status
Starting to authenticate
Successfully authenticated
CLI is authenticated against the Keptn cluster http://YOUR.DOMAIN/api
Access the Keptn Swagger API documentation in your browser at: http://YOUR.DOMAIN/api
The index page of the Swagger API documentation looks as follows:
Select one of the two API collections:
api-service
contains endpoints to authenticate, get Keptn metadata, create/delete a project, to create service, and to send/get events.
configuration-service
provides GET endpoints for project/stage/service and endpoints for resource management.
mongodb-datastore
provides GET endpoint to retrieve Keptn events.
Clicking on an endpoint reveals more details how to use it, including definitions and examples of the payload.
Keptn 0.6.2 introduced an NGINX as new K8s deployment and service called api-gateway-ngnix
shown in the figure below. This NGINX allows to route the traffic and ensures that all requests are authenticated using the /auth
endpoint of the api-service
.
api-service
now does not implement endpoints of the configuration-service
anymore.configuration-service
is exposed to the public. Endpoints that are not intended to be used from the public (e.g., deleting a project) are marked and the description is accordingly adapted.mongodb-datastore
is exposed to the public. Endpoints that are not intended to be used from the public are marked and the description is accordingly adapted.Architecture of Keptn installation: