> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ubik-agent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first API call and see UBIK in action in less than 5 minutes.

Welcome to the UBIK API! This guide will walk you through making your first API call in just a few minutes.

<Steps>
  <Step title="Get your API Key">
    Your API key is your passport to the UBIK ecosystem. You'll need it to authenticate all of your API requests. You can find your API key in your user settings page on the UBIK dashboard.

    <Card title="Go to API Key Settings" icon="key" href="https://app.ubik-agent.com/user/security" />

    <Tip>
      Keep your API key secure as if it were a password and do not share it publicly.
    </Tip>
  </Step>

  <Step title="Make Your First Request">
    Let's verify that your API key is working correctly by fetching your user details. We'll use the `/users/me` endpoint, which provides information about the authenticated user.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X GET "https://app.ubik-agent.com/api/v1/users/me" \
           -H "X-API-KEY: YOUR_API_KEY"
      ```

      ```python Python theme={null}
      import requests

      api_key = "YOUR_API_KEY"
      headers = {
          "X-API-KEY": api_key
      }
      response = requests.get(
          "https://app.ubik-agent.com/api/v1/users/me",
          headers=headers
      )
      print(response.json())
      ```

      ```javascript JavaScript theme={null}
      const apiKey = "YOUR_API_KEY";
      const headers = {
        "X-API-KEY": apiKey,
      };

      fetch("https://app.ubik-agent.com/api/v1/users/me", {
        method: "GET",
        headers: headers,
      })
        .then((response) => response.json())
        .then((data) => console.log(data))
        .catch((error) => console.error("Error:", error));
      ```
    </CodeGroup>
  </Step>

  <Step title="Check the Response">
    If everything is correct, you'll receive a `200 OK` response with a JSON object containing your user details.

    ```json Response theme={null}
    {
      "username": "testuser",
      "full_name": "Test User",
      "uuid_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "created_at": "2025-09-28T12:00:00Z",
      "balance": 100.0,
      "chat_session_count": 5,
      "document_count": 42,
      "workspace_count": 3,
      "assistant_count": 2,
      "skill_count": 1
    }
    ```
  </Step>
</Steps>

Congratulations! You've successfully made your first API call.

## Next Steps

Now that you're set up, you're ready to explore more.

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="book-open" href="/en/development">
    Understand the fundamental building blocks of the UBIK API.
  </Card>

  <Card title="Step-by-Step Guides" icon="list-checks" href="/en/guides/managing-workspaces">
    Follow our guides to learn common workflows.
  </Card>
</CardGroup>
