REST API

REST APIs for extending Layer5 Cloud.
Tags:
Categories:

To create integrations, retrieve data, and automate your cloud native infrastructure, build with the Layer5 Cloud REST API.

In order to authenticate to Layer5 Cloud’s REST API, you need to generate and use a security token. Visit your user account’s security tokens and generate a long-lived token. Security tokens remain valid until you revoke them, and you can issue as many as you need.

To authenticate with the API, pass the token as a bearer token in the Authorization header. For example, in cURL:

curl <protocol>://<Layer5-cloud-hostname>/api/identity/users/profile \
-H "Authorization: Bearer <token>"
  • Replace <protocol> with http or https depending on your Layer5 Cloud instance.
  • Replace <Layer5-cloud-hostname> with the hostname or IP address of your hosted Layer5 Cloud instance. For example, https://cloud.layer5.io.
  • Replace the path with the API endpoint you want to access.
  • Replace <token> with the security token you generated.

There are two ways to control the organization context for your API requests:

Include the layer5-current-orgid header with your organization’s ID to specify the target organization for a request:

curl -X GET "https://cloud.layer5.io/api/environments" \
 -H "Authorization: Bearer <Your-Token>" \
 -H "layer5-current-orgid: <Your-Organization-ID>"
const token = "Your-Token";
const orgId = "Your-Organization-ID";

async function listEnvironments() {
  const res = await fetch("https://cloud.layer5.io/api/environments", {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "layer5-current-orgid": orgId,
    },
  });
  const data = await res.json();
  console.log(data);
}

listEnvironments();
import requests

url = "https://cloud.layer5.io/api/environments"
headers = {
    "Authorization": "Bearer <Your-Token>",
    "layer5-current-orgid": "<Your-Organization-ID>"
}

res = requests.get(url, headers=headers)
print(res.json())

Alternatively, you can set your default organization and workspace using the Preferences API. This sets your user preferences so that subsequent API requests will use the specified organization and workspace context:

# Set organization and workspace preferences
curl -X PUT "https://cloud.layer5.io/api/identity/users/preferences" \
 -H "Authorization: Bearer <Your-Token>" \
 -H "Content-Type: application/json" \
 -d '{
   "selectedOrganization": "<Your-Organization-ID>",
   "selectedWorkspace": "<Your-Workspace-ID>"
 }'
const token = "Your-Token";

async function setPreferences() {
  const res = await fetch("https://cloud.layer5.io/api/identity/users/preferences", {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      selectedOrganization: "<Your-Organization-ID>",
      selectedWorkspace: "<Your-Workspace-ID>",
    }),
  });
  const data = await res.json();
  console.log(data);
}

setPreferences();
import requests
import json

url = "https://cloud.layer5.io/api/identity/users/preferences"
headers = {
    "Authorization": "Bearer <Your-Token>",
    "Content-Type": "application/json"
}
payload = {
    "selectedOrganization": "<Your-Organization-ID>",
    "selectedWorkspace": "<Your-Workspace-ID>"
}

res = requests.put(url, headers=headers, data=json.dumps(payload))
print(res.json())

The following example demonstrate how to retrieve information from the Academy REST APIs.

Use the Layer5 Cloud API to retrieve the total number of registered learners. Pass your Security Token as a Bearer token in the Authorization header (as shown in Authenticating with API). The response JSON includes an array of user objects.

curl -s -X GET "https://cloud.layer5.io/api/academy/cirricula"  \
 -H "Authorization: Bearer <Your-Token>"  \
  | jq '[.data[].registration_count] | add'
const token = "Your-Token"

async function getTotalLearners() {
  const res = await fetch("https://cloud.layer5.io/api/academy/cirricula", {
    headers: { Authorization: `Bearer ${token}` },
  });
  const data = await res.json();
  const total = data.data.reduce((sum, path) => sum + path.registration_count, 0);
  console.log(total);
}

getTotalLearners();
import requests

url = "https://cloud.layer5.io/api/academy/cirricula"
headers = {"Authorization": "Bearer <Your-Token>"}

res = requests.get(url, headers=headers)
data = res.json()
total = sum(item["registration_count"] for item in data["data"])
print(total)
package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

type Path struct {
	RegistrationCount int `json:"registration_count"`
}

type Response struct {
	Data []Path `json:"data"`
}

func main() {
	url := "https://cloud.layer5.io/api/academy/cirricula"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Set("Authorization", "Bearer <your-token>")

	client := &http.Client{}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)

	var response Response
	if err := json.Unmarshal(body, &response); err != nil {
		panic(err)
	}

	total := 0
	for _, path := range response.Data {
		total += path.RegistrationCount
	}

	fmt.Println(total)
}

This returns the number of Total registered learners:

130
REST API Reference

Complete reference of all Layer5 Cloud REST API endpoints

Last modified April 6, 2026: Feedback: Split into 2 pages, reduce encapsulation, add animation, and minor fixes (0c24100c)