Getting Started

Quick Start

Get up and running with the Klarora API in under 5 minutes.

Create an API Key

Generate an API key from your team settings in the Klarora dashboard.

Install the SDK

Choose your preferred language and install the official SDK.

Make Your First Request

Initialize the client and start interacting with the API.

1Create an API Key

First, you'll need to create an API key to authenticate your requests:

Go to your Team Settings
Navigate to the Developer tab
Click Create Key
Select the scopes your integration needs
Copy and securely store your API key

Keep your API key secret

Your API key grants access to your team's data. Never expose it in client-side code or public repositories.

2Install the SDK

Install the official SDK for your programming language:

javascript

npm install @kairos-connect/sdk

python

pip install kairos-sdk

go get github.com/moemollaei-org/kairos-connect-sdks/go

Bun

bun add @kairos-connect/sdk

3Make Your First Request

Initialize the client and start making API requests:

index.ts

typescript

1import { Kairos } from '@kairos-connect/sdk';
2
3const kairos = new Kairos({
4  apiKey: process.env.KAIROS_API_KEY,
5});
6
7// List in-progress tasks
8const { data: tasks, pagination } = await kairos.tasks.list({
9  status: 'in_progress',
10  limit: 10,
11});
12
13console.log(`Found ${pagination.total} tasks`);
14
15// Create a new task
16const task = await kairos.tasks.create({
17  title: 'Review quarterly report',
18  priority: 'high',
19  goal_id: 'goal_abc123',
20});
21console.log(`Created: ${task.id}`);

Environment variables

Store your API key in an environment variable like KAIROS_API_KEY rather than hardcoding it in your application.

Next Steps

Authentication

Learn about API key scopes and authentication methods

Tasks API

Complete reference for the Tasks API endpoints