# Get Started with SkhokhoAI

### 1) Create your SkhokhoAI account (Org Owner)

1. Go to [**https://skhokho.ai**](https://skhokho.ai) and click **Create account**.
2. Complete sign-up. The first user automatically becomes the **Organization Owner**.

### 2) Invite your team

As the **Organization Owner**, you can invite teammates to collaborate under your org:

1. Open **Organization settings → User Managemt**.
2. Click **Invite member**, add email(s), assign the appropriate role(s).
3. Send invites. Users will receive an email to join your organization.

> For more information on setup, see the public help center: [**https://skhokho.ai/public-help/**](https://skhokho.ai/public-help/)

### 3) Understand authentication (Basic Auth)

The SkhokhoAI API uses **HTTP Basic Authentication** (username + password) over TLS.

* **Username**: your SkhokhoAI account email
* **Password**: your SkhokhoAI account password
* The client sends `Authorization: Basic <base64(username:password)>`.
* **Do not** hardcode credentials. Store them securely (password manager / secrets manager) and load them via environment variables.

***

### 4) Make your first call

Once your credentials are ready, you can test the API using any HTTP client.

You can now start using the API to make calls (e.g: User Profile, Organization Management, etc..) for testing.

### Example:

<figure><img src="/files/kJNvYzHSU1t7J4MbC8wu" alt=""><figcaption></figcaption></figure>

#### Step 1: Open any read-only endpoint

**User Profile → `GET /api/v1.0/me/`**

This endpoint returns the profile of the currently authenticated user.

#### Step 2: Click **Test it**

On the right-hand panel, click the blue **Test it** button.

#### Step 3: Enter your credentials

1. In the **Authorizations** dropdown, select **basicAuth**
2. Enter your **SkhokhoAI username (email)** and **password**

> The API uses HTTP Basic Auth. GitBook automatically encodes and sends the credentials for you.

#### Step 4: Click **Send**

GitBook will perform the request and display:

* Status code (e.g. `200 Success`)
* Response body (JSON)
* Headers

#### Step 6: Validate the response

A `200 OK` response confirms your:

* Account is active
* Basic Auth is working
* Organization access is valid

You are now ready to start using the API for automation and integration.

### Important: Never hardcode your credentials

Configure environment variables (recommended). Set credentials once; reference them everywhere.

```
SKHOKHOAI_USERNAME="you@example.com"
SKHOKHOAI_PASSWORD="your-strong-password"
SKHOKHOAI_BASE_URL="https://skhokho.ai" 

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.skhokho.ai/get-started-with-skhokhoai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.