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

# Introduction

> Build on Gennia. The Public API lets you create agents, run conversations, manage clients and configure your hub programmatically.

The Gennia Public API is a REST API for everything you can do as a hub operator. With it you can:

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/en/api-reference/quickstart">
    Create agents, configure prompts, link tools, skills, knowledge sources and channels.
  </Card>

  <Card title="Conversations" icon="comments" href="/en/api-reference/quickstart">
    Send messages, stream responses (SSE), list conversations and their messages.
  </Card>

  <Card title="Hub" icon="building" href="/en/api-reference/quickstart">
    Manage your hub identity, domain, access policies, external links and clients.
  </Card>

  <Card title="Billing" icon="credit-card" href="/en/api-reference/quickstart">
    Configure plans, credit packages, coupons and inspect client subscriptions.
  </Card>
</CardGroup>

## Base URL

```
https://api.gennia.ai
```

All endpoints live under `/public/api/v1/`.

## What it's not

This API is **workspace-scoped**, not user-scoped. There is no end-user OAuth flow here. The API key authenticates a *workspace*, and every operation runs as that workspace.

For end-user authentication into the Hub portal (where your clients sign in to chat with agents), see the Hub product documentation.

## Format

* All requests and responses use `application/json` (unless noted, like file uploads).
* All IDs in URLs are UUIDs.
* Timestamps are ISO 8601 with timezone (`2026-12-31T23:59:59Z`).
* Strict request body parsing — unknown fields return `400 VALIDATION_ERROR`.

## Next steps

<Steps>
  <Step title="Create an API key">
    Generate a workspace API key inside Studio. See [Authentication](/en/api-reference/authentication).
  </Step>

  <Step title="Make your first call">
    Follow the [Quickstart](/en/api-reference/quickstart) to list agents and send a message in under five minutes.
  </Step>

  <Step title="Explore the reference">
    Every endpoint is documented in the API Reference tab with try-it-out and full schemas.
  </Step>
</Steps>