List entities

List entities in the same workspace.

GET

/entities

Query parameters

Name	Type	Description	Required
page	number	Which page to fetch min: 1, max: 9007199254740991
pageSize	number	Page size to use min: 1, max: 30
status	"ACTIVE" | "INACTIVE"	Entity status
sortBy	| "name" | "status" | "createdAt" | "updatedAt"	Sort by attribute
sortOrder	"asc" | "desc"	Sort order

Response schema

{

// Current page

page: number;

// Next page or null if there is none

next: number | null;

// Previous page or null if there is none

prev: number | null;

// Max count of items per page

pageSize: number;

// Total count of items

total: number;

// Array of results

results: Array<{

// Entity ID

id: string;

// Legacy internal unique identifier (for retro-compatibility)

legacyId: number;

// Entity name

name: string;

// Entity status

status: "ACTIVE" | "INACTIVE";

// Creation timestamp

createdAt: string;

// Last modification timestamp

updatedAt: string;

}>;

}

Examples

Bash

curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {jwt}" \
  "$API_BASE_URL/entities"

Typescript

const url = "<base-url>/entities";

const headers = {
  "Content-Type": "application/json",
  Authorization: "Bearer <jwt>"
};

fetch(url, { headers }).then(res => {
  console.log(res)
});

Python

import requests

url = "<base-url>/entities"

headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer <jwt>"
}

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