How to use ThirdEye API
ThirdEye exposes a consistent CRUD API. This make it easy to use ThirdEye as a headless service, from your apps. The easiest way to discover and try the different endpoints is to use Swagger.
Swagger is exposed by the coordinator at
If you use StarTree ThirdEye or the helm charts, Swagger is also exposed by the frontend app at
- Go to
- If your instance uses authentication, click the "Authorize" button and provide a bearer token.
- If your instance use HTTPS, switch HTTP to HTTPS.
- Try the endpoints.
Obtaining a bearer token.
If your instance use authentication, the frontend passes a Bearer Token when performing requests.
In your browser, in the devtools, you can see the Bearer token.
You can copy and paste the token in the Swagger UI.
Obtaining a long-lasting token (Basic auth token).
For StarTree cloud users (BYOC or SaaS) - skip Step 1 and 2 below and instead please reach out to StarTree Tech Support to obtain a basic auth token for StarTree ThirdEye.
Step 1 - Update ThirdEye configuration in the Helm chart
- username: <USERNAME>
Step 2 - Use the generated Basic Auth token in requests
To authenticate a request, add the
Authorization header with the token value as the base64 encoded value of
username:password prefixed with
Authorization: Basic YWRtaW46cGFzcw== where
YWRtaW46cGFzcw== is the base64 encoded value of
To encode on macOs:
echo -D '<USERNAME>:<PASSWORD>' | base64
Step 3 - Use the Basic Auth token in Swagger
Copy and paste the token
YWRtaW46cGFzcw== in the Swagger UI as