> ## 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.

# Introdução

> Construa em cima da Gennia. A API pública permite criar agentes, executar conversas, gerenciar clientes e configurar seu hub via código.

A API pública da Gennia é uma REST API que expõe tudo o que você consegue fazer como operador de hub. Com ela você pode:

<CardGroup cols={2}>
  <Card title="Agentes" icon="robot" href="/pt/api-reference/quickstart">
    Criar agentes, configurar prompts, vincular ferramentas, skills, bases de conhecimento e canais.
  </Card>

  <Card title="Conversas" icon="comments" href="/pt/api-reference/quickstart">
    Enviar mensagens, receber respostas em streaming (SSE), listar conversas e mensagens.
  </Card>

  <Card title="Hub" icon="building" href="/pt/api-reference/quickstart">
    Gerenciar identidade do hub, domínio, políticas de acesso, links externos e clientes.
  </Card>

  <Card title="Cobrança" icon="credit-card" href="/pt/api-reference/quickstart">
    Configurar planos, pacotes de créditos, cupons e consultar assinaturas dos clientes.
  </Card>
</CardGroup>

## URL base

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

Todos os endpoints ficam sob `/public/api/v1/`.

## O que ela não é

Essa API é **escopada por workspace**, não por usuário. Não tem fluxo OAuth de end-user aqui. A API key autentica um *workspace*, e toda operação roda como aquele workspace.

Para autenticação de end-user no portal do Hub (onde seus clientes entram para conversar com agentes), veja a documentação do produto Hub.

## Formato

* Todas as requisições e respostas usam `application/json` (exceto file uploads).
* Todos os IDs nas URLs são UUIDs.
* Timestamps em ISO 8601 com timezone (`2026-12-31T23:59:59Z`).
* Parsing estrito do request body — campos desconhecidos retornam `400 VALIDATION_ERROR`.

## Próximos passos

<Steps>
  <Step title="Criar uma API key">
    Gere uma API key de workspace no Studio. Veja [Autenticação](/pt/api-reference/authentication).
  </Step>

  <Step title="Fazer a primeira chamada">
    Siga o [Quickstart](/pt/api-reference/quickstart) para listar agentes e enviar uma mensagem em menos de cinco minutos.
  </Step>

  <Step title="Explorar a referência">
    Cada endpoint está documentado na aba API Reference com try-it-out e schemas completos.
  </Step>
</Steps>