# Gennia

## Docs

- [Create automation](https://docs.gennia.ai/api-reference/agent-automations/create-automation.md): Delegates to AgentWorkflowService.createInternal — runs the full pipeline including cron + timezone validation and JobRunr recurring-job registration. Schedules created via API DO fire (was a bug in the initial PR).
- [Delete (soft) automation](https://docs.gennia.ai/api-reference/agent-automations/delete-soft-automation.md): Delegates to AgentWorkflowService.deleteInternal — cancels the JobRunr job before soft-deleting.
- [Get automation](https://docs.gennia.ai/api-reference/agent-automations/get-automation.md)
- [List automation executions (paginated)](https://docs.gennia.ai/api-reference/agent-automations/list-automation-executions-paginated.md)
- [List automations](https://docs.gennia.ai/api-reference/agent-automations/list-automations.md)
- [Update automation](https://docs.gennia.ai/api-reference/agent-automations/update-automation.md): Delegates to AgentWorkflowService.updateInternal — runs syncJobrunrState to register/update/cancel the recurring job based on the new state.
- [Configure (Step 2): set isActive / channelSpecificConfig / credentials](https://docs.gennia.ai/api-reference/agent-channels/configure-step-2:-set-isactive-channelspecificconfig-credentials.md): credentials are persisted as encrypted WorkspaceSecrets following the same naming convention used by Studio web (e.g. zapi_<instance_id>_instance_token). They are NEVER returned in responses.
- [Connect a channel (Step 1: connection only, no config)](https://docs.gennia.ai/api-reference/agent-channels/connect-a-channel-step-1:-connection-only-no-config.md)
- [Delete a channel connection](https://docs.gennia.ai/api-reference/agent-channels/delete-a-channel-connection.md)
- [Get a channel connection](https://docs.gennia.ai/api-reference/agent-channels/get-a-channel-connection.md)
- [Get a channel connection by channel type](https://docs.gennia.ai/api-reference/agent-channels/get-a-channel-connection-by-channel-type.md)
- [List channel connections on the agent](https://docs.gennia.ai/api-reference/agent-channels/list-channel-connections-on-the-agent.md)
- [Toggle STATIC/DYNAMIC instance mode](https://docs.gennia.ai/api-reference/agent-channels/toggle-staticdynamic-instance-mode.md)
- [Create command](https://docs.gennia.ai/api-reference/agent-commands/create-command.md)
- [Delete (soft) command](https://docs.gennia.ai/api-reference/agent-commands/delete-soft-command.md)
- [Get command](https://docs.gennia.ai/api-reference/agent-commands/get-command.md)
- [List commands](https://docs.gennia.ai/api-reference/agent-commands/list-commands.md)
- [Update command](https://docs.gennia.ai/api-reference/agent-commands/update-command.md)
- [Link an External MCP server to the agent](https://docs.gennia.ai/api-reference/agent-external-mcps/link-an-external-mcp-server-to-the-agent.md)
- [List External MCPs linked to the agent](https://docs.gennia.ai/api-reference/agent-external-mcps/list-external-mcps-linked-to-the-agent.md)
- [Unlink an External MCP server from the agent](https://docs.gennia.ai/api-reference/agent-external-mcps/unlink-an-external-mcp-server-from-the-agent.md)
- [Update an External MCP link (active / requiresApproval / instanceMode)](https://docs.gennia.ai/api-reference/agent-external-mcps/update-an-external-mcp-link-active-requiresapproval-instancemode.md)
- [Workspace External MCPs (status=CONNECTED) NOT yet linked](https://docs.gennia.ai/api-reference/agent-external-mcps/workspace-external-mcps-status=connected-not-yet-linked.md)
- [Get a single feature](https://docs.gennia.ai/api-reference/agent-features/get-a-single-feature.md)
- [List all features on the agent](https://docs.gennia.ai/api-reference/agent-features/list-all-features-on-the-agent.md)
- [Update a single feature](https://docs.gennia.ai/api-reference/agent-features/update-a-single-feature.md): Both `enabled` and `config` are optional. Cross-field validation per feature is enforced and reported as `FEATURE_VALIDATION_ERROR`.
- [Link an HTTP tool to the agent](https://docs.gennia.ai/api-reference/agent-http-tools/link-an-http-tool-to-the-agent.md)
- [List HTTP tools linked to the agent](https://docs.gennia.ai/api-reference/agent-http-tools/list-http-tools-linked-to-the-agent.md)
- [Unlink an HTTP tool from the agent](https://docs.gennia.ai/api-reference/agent-http-tools/unlink-an-http-tool-from-the-agent.md)
- [Update a tool link (active / requiresApproval)](https://docs.gennia.ai/api-reference/agent-http-tools/update-a-tool-link-active-requiresapproval.md)
- [Workspace HTTP tools NOT yet linked to the agent](https://docs.gennia.ai/api-reference/agent-http-tools/workspace-http-tools-not-yet-linked-to-the-agent.md)
- [Link a knowledge source to the agent](https://docs.gennia.ai/api-reference/agent-knowledge-sources/link-a-knowledge-source-to-the-agent.md)
- [List knowledge sources linked to the agent](https://docs.gennia.ai/api-reference/agent-knowledge-sources/list-knowledge-sources-linked-to-the-agent.md)
- [Unlink a knowledge source from the agent](https://docs.gennia.ai/api-reference/agent-knowledge-sources/unlink-a-knowledge-source-from-the-agent.md)
- [Workspace knowledge sources NOT yet linked](https://docs.gennia.ai/api-reference/agent-knowledge-sources/workspace-knowledge-sources-not-yet-linked.md)
- [Get the agent's model selection + capabilities](https://docs.gennia.ai/api-reference/agent-model/get-the-agents-model-selection-+-capabilities.md)
- [Update the agent's model selection](https://docs.gennia.ai/api-reference/agent-model/update-the-agents-model-selection.md): Shortcut over PATCH /agents/{id} for aiModelPublicId, temperature, thinkingEnabled and thinkingEffort. Validates temperature against the resolved model when both arrive in the same body.
- [Link one or more Native MCP connections to the agent](https://docs.gennia.ai/api-reference/agent-native-mcps/link-one-or-more-native-mcp-connections-to-the-agent.md): Connections not found in the workspace, or not in ACTIVE state, are skipped silently and reported in the response's `skipped` array. The response also surfaces the requested vs linked counts so the caller can detect partial successes without inspecting the skipped list.
- [List Native MCP connections linked to the agent](https://docs.gennia.ai/api-reference/agent-native-mcps/list-native-mcp-connections-linked-to-the-agent.md)
- [Toggle STATIC/DYNAMIC instance mode for a linked connection](https://docs.gennia.ai/api-reference/agent-native-mcps/toggle-staticdynamic-instance-mode-for-a-linked-connection.md)
- [Unlink a Native MCP connection from the agent](https://docs.gennia.ai/api-reference/agent-native-mcps/unlink-a-native-mcp-connection-from-the-agent.md)
- [Workspace Native MCP connections (ACTIVE) NOT yet linked to the agent](https://docs.gennia.ai/api-reference/agent-native-mcps/workspace-native-mcp-connections-active-not-yet-linked-to-the-agent.md): Fetches both the workspace's connections and the agent's linked set, then returns the difference. Excludes connections in non-ACTIVE states.
- [Get the agent's prompt + variables](https://docs.gennia.ai/api-reference/agent-prompt/get-the-agents-prompt-+-variables.md)
- [Update systemPrompt and/or dynamicPromptEnabled](https://docs.gennia.ai/api-reference/agent-prompt/update-systemprompt-andor-dynamicpromptenabled.md): Shortcut over PATCH /agents/{id} for the two prompt-related fields. Setting either flips hasUnpublishedChanges=true on the underlying agent.
- [Link a skill to the agent](https://docs.gennia.ai/api-reference/agent-skills/link-a-skill-to-the-agent.md)
- [List skills linked to the agent](https://docs.gennia.ai/api-reference/agent-skills/list-skills-linked-to-the-agent.md)
- [Unlink a skill from the agent](https://docs.gennia.ai/api-reference/agent-skills/unlink-a-skill-from-the-agent.md)
- [Workspace skills NOT yet linked to the agent](https://docs.gennia.ai/api-reference/agent-skills/workspace-skills-not-yet-linked-to-the-agent.md)
- [Link a sub-agent (no PATCH afterwards — to change, unlink + re-link)](https://docs.gennia.ai/api-reference/agent-sub-agents/link-a-sub-agent-no-patch-afterwards-—-to-change-unlink-+-re-link.md)
- [List linked sub-agents](https://docs.gennia.ai/api-reference/agent-sub-agents/list-linked-sub-agents.md)
- [Unlink a sub-agent](https://docs.gennia.ai/api-reference/agent-sub-agents/unlink-a-sub-agent.md)
- [Workspace agents available as sub-agents (excludes self & cycles)](https://docs.gennia.ai/api-reference/agent-sub-agents/workspace-agents-available-as-sub-agents-excludes-self-&-cycles.md)
- [Create variable](https://docs.gennia.ai/api-reference/agent-variables/create-variable.md)
- [Delete variable (remove from prompt or purge)](https://docs.gennia.ai/api-reference/agent-variables/delete-variable-remove-from-prompt-or-purge.md): `mode=remove_from_prompt` (default) removes `{{name}}` from the system prompt and leaves the variable + per-installation values intact. `mode=purge` is irreversible: soft-deletes the variable and cascades to all hub-client values. Purge requires body `{"confirmation":"EXCLUIR"}`.
- [List variables](https://docs.gennia.ai/api-reference/agent-variables/list-variables.md)
- [Update variable](https://docs.gennia.ai/api-reference/agent-variables/update-variable.md)
- [Get a specific published version snapshot](https://docs.gennia.ai/api-reference/agent-versions/get-a-specific-published-version-snapshot.md)
- [Get current published version snapshot](https://docs.gennia.ai/api-reference/agent-versions/get-current-published-version-snapshot.md)
- [List versions](https://docs.gennia.ai/api-reference/agent-versions/list-versions.md): Paginated published-version snapshots, ordered by versionNumber DESC.
- [Restore the editable state from a published version](https://docs.gennia.ai/api-reference/agent-versions/restore-the-editable-state-from-a-published-version.md): Overwrites the agent's editable state (and linked tools/skills/knowledge/sub-agents) with the contents of the chosen version. Discards any unpublished changes. After restore, hasUnpublishedChanges=false (per OQ #5).
- [Create agent](https://docs.gennia.ai/api-reference/agents/create-agent.md): Create a new agent with status=draft and an empty draft version (no model, no system prompt). Configure the draft via Part B endpoints and call publish to make it active.
- [Delete agent](https://docs.gennia.ai/api-reference/agents/delete-agent.md): Soft-delete the agent.
- [Get agent](https://docs.gennia.ai/api-reference/agents/get-agent.md)
- [List agents](https://docs.gennia.ai/api-reference/agents/list-agents.md): Paginated list of agents in the workspace bound to the API key.
- [Publish agent](https://docs.gennia.ai/api-reference/agents/publish-agent.md): Promote the current draft to published. Creates a fresh draft initialized from the just-published version. Requires the draft to have an AI model set; system prompt may be empty.
- [Update agent](https://docs.gennia.ai/api-reference/agents/update-agent.md): Patch metadata fields (name, description, categories, avatarUrl). Use null to clear nullable fields. Status transitions are NOT done via PATCH — use publish.
- [List AI models](https://docs.gennia.ai/api-reference/ai-models/list-ai-models.md): Returns the union of (a) global catalog models and (b) custom models owned by the workspace bound to the API key. Optional filters apply in memory.
- [Create coupon](https://docs.gennia.ai/api-reference/billing/create-coupon.md): Creates a coupon. **Side effect:** a Stripe Coupon + Promotion Code are created. Restrictions: percentage discounts must be 1-100; `duration=repeating` requires `durationMonths`; `discountType=fixed_amount` requires `applicablePlanIds`; plans in `applicablePlanIds` must already have a Stripe product…
- [Create credit package](https://docs.gennia.ai/api-reference/billing/create-credit-package.md): Creates a credit package. No Stripe integration — billing for credit packages happens via plans. `renewalIntervalMonths=null` means one-time / non-renewable. Name must be unique within the hub.
- [Create plan](https://docs.gennia.ai/api-reference/billing/create-plan.md): Creates a plan. **Side effect:** a Stripe Product + Price + Payment Link are created automatically. Provide either `packagePublicId` (existing bundle) or `content` (inline bundle, created automatically). Workspaces without Stripe Connect configured will fail here.
- [Delete coupon](https://docs.gennia.ai/api-reference/billing/delete-coupon.md): Soft-deletes the coupon and deactivates the Stripe promotion code.
- [Delete credit package](https://docs.gennia.ai/api-reference/billing/delete-credit-package.md): Soft-deletes. Blocked if there are plans referencing this package.
- [Delete plan](https://docs.gennia.ai/api-reference/billing/delete-plan.md): Soft-deletes the plan. Blocked by the internal service if there are active subscribers.
- [Get coupon](https://docs.gennia.ai/api-reference/billing/get-coupon.md)
- [Get credit package](https://docs.gennia.ai/api-reference/billing/get-credit-package.md)
- [Get plan](https://docs.gennia.ai/api-reference/billing/get-plan.md)
- [List coupons](https://docs.gennia.ai/api-reference/billing/list-coupons.md): Paginated list of coupons.
- [List credit packages](https://docs.gennia.ai/api-reference/billing/list-credit-packages.md): Paginated list with `plansUsingCount` per item.
- [List plans](https://docs.gennia.ai/api-reference/billing/list-plans.md): Paginated list of plans in the workspace.
- [Replace credit package](https://docs.gennia.ai/api-reference/billing/replace-credit-package.md): Full replace (PUT, not PATCH — mirrors the internal controller). All required fields must be present in the body.
- [Update coupon](https://docs.gennia.ai/api-reference/billing/update-coupon.md): Limited update: only `name`, `active`, `maxUses`, `validUntil` can be changed (Stripe limitation). To change the code, discount, duration, scope or plans → delete and re-create. `active` is synced with the Stripe promotion code.
- [Update plan](https://docs.gennia.ai/api-reference/billing/update-plan.md): Partial update. Immutable fields not exposed: currency, billingType, billingIntervalMonths (Stripe doesn't allow changing a Price). Changing `priceCents` while the plan has active subscriptions fails with 400.
- [Get channel type](https://docs.gennia.ai/api-reference/channel-types/get-channel-type.md)
- [List channel types](https://docs.gennia.ai/api-reference/channel-types/list-channel-types.md)
- [Create client](https://docs.gennia.ai/api-reference/clients/create-client.md): Manually creates a client workspace with users. Optionally sends invitation emails. When `inviteToTrial=true`, the hub's configured trial plan is used and `planPublicId` is ignored (requires trial enabled in hub config).
- [Get client](https://docs.gennia.ai/api-reference/clients/get-client.md)
- [List clients](https://docs.gennia.ai/api-reference/clients/list-clients.md): Paginated list of client workspaces in the hub bound to the API key.
- [Reactivate client](https://docs.gennia.ai/api-reference/clients/reactivate-client.md): Restores the Stripe subscription for a suspended client.
- [Remove client user](https://docs.gennia.ai/api-reference/clients/remove-client-user.md): Soft-deletes a user from the client workspace. Cannot remove the last admin. Returns 200 with the updated client (mirrors the internal controller).
- [Resend client invitation](https://docs.gennia.ai/api-reference/clients/resend-client-invitation.md): Re-sends a pending invitation email and renews its expiration date.
- [Suspend client](https://docs.gennia.ai/api-reference/clients/suspend-client.md): Cancels the Stripe subscription (at period end) and marks the client as suspended. Only `active` clients can be suspended.
- [Update client user](https://docs.gennia.ai/api-reference/clients/update-client-user.md): Updates a user's name and role within the client workspace. Cannot demote the last admin.
- [Delete conversation](https://docs.gennia.ai/api-reference/conversations/delete-conversation.md): Soft-delete the conversation.
- [Get conversation](https://docs.gennia.ai/api-reference/conversations/get-conversation.md)
- [List conversation messages](https://docs.gennia.ai/api-reference/conversations/list-conversation-messages.md): Paginated messages for a conversation. Default order is ascending (oldest first). Use `order=desc` for newest first.
- [List conversations](https://docs.gennia.ai/api-reference/conversations/list-conversations.md): Paginated list of conversations in the workspace bound to the API key.
- [Create an External MCP server (auth + sync discovery)](https://docs.gennia.ai/api-reference/external-mcps/create-an-external-mcp-server-auth-+-sync-discovery.md): Persists the server with status=PENDING, encrypts the auth value as a WorkspaceSecret, then runs synchronous tool discovery (~10s). Returns 201 with the populated tools list on success, or 201 with status=ERROR if discovery failed (server still persisted so the caller can update later). OAUTH_AUTHOR…
- [Delete (soft) an External MCP server](https://docs.gennia.ai/api-reference/external-mcps/delete-soft-an-external-mcp-server.md)
- [Get an External MCP server](https://docs.gennia.ai/api-reference/external-mcps/get-an-external-mcp-server.md)
- [List External MCP servers](https://docs.gennia.ai/api-reference/external-mcps/list-external-mcp-servers.md)
- [Re-run synchronous discovery against the server](https://docs.gennia.ai/api-reference/external-mcps/re-run-synchronous-discovery-against-the-server.md)
- [Update an External MCP server](https://docs.gennia.ai/api-reference/external-mcps/update-an-external-mcp-server.md): Updates name/url/auth fields. Sending a new authValue/authHeaders rotates the secret. url or auth change triggers sync re-discovery. OAUTH_AUTHORIZATION_CODE rejected.
- [Create HTTP tool](https://docs.gennia.ai/api-reference/http-tools/create-http-tool.md)
- [Delete (soft) HTTP tool](https://docs.gennia.ai/api-reference/http-tools/delete-soft-http-tool.md)
- [Get HTTP tool](https://docs.gennia.ai/api-reference/http-tools/get-http-tool.md)
- [List workspace HTTP tools](https://docs.gennia.ai/api-reference/http-tools/list-workspace-http-tools.md)
- [Test the HTTP tool against its configured target](https://docs.gennia.ai/api-reference/http-tools/test-the-http-tool-against-its-configured-target.md)
- [Update HTTP tool](https://docs.gennia.ai/api-reference/http-tools/update-http-tool.md)
- [Get hub access settings](https://docs.gennia.ai/api-reference/hub-access/get-hub-access-settings.md): Returns access configuration: public vs private, default plan (for public hubs), self-service toggle, login banner URL.
- [Update hub access settings](https://docs.gennia.ai/api-reference/hub-access/update-hub-access-settings.md): Partial update. When setting `accessType=public`, the hub must have a `defaultPlanPublicId` (in this request or already on the hub) — and that plan must be free (priceCents=0). Otherwise the request fails with 400. The banner image is uploaded separately via `POST /hub/logos/banner`.
- [Check subdomain availability](https://docs.gennia.ai/api-reference/hub-domain/check-subdomain-availability.md): Read-only check — does NOT mutate the hub. Returns `available=false` with `reason=reserved` when the subdomain is on the reserved list, or `reason=taken` when another hub already uses it. This check does NOT exclude the caller's current hub — querying your own subdomain returns `reason=taken`.
- [Get hub domain](https://docs.gennia.ai/api-reference/hub-domain/get-hub-domain.md): Returns the current subdomain and the full hub URL derived from it.
- [Update hub subdomain](https://docs.gennia.ai/api-reference/hub-domain/update-hub-subdomain.md): Replaces the hub's subdomain. **Side effect:** when the subdomain actually changes, all Stripe payment links for this hub are recreated — any external URLs holding the previous payment link will stop working. Use `GET /hub/domain/availability` to validate the new subdomain before calling this.
- [Create external link](https://docs.gennia.ai/api-reference/hub-external-links/create-external-link.md): Creates a new external link. `displayOrder` is auto-assigned (last + 1). Titles must be unique within the hub; the hub is capped at 10 links.
- [Delete external link](https://docs.gennia.ai/api-reference/hub-external-links/delete-external-link.md): Soft-deletes the link. Deleting an already-deleted link returns 404.
- [List external links](https://docs.gennia.ai/api-reference/hub-external-links/list-external-links.md): Returns all external links of the hub ordered by display order. No pagination — hubs are capped at 10 links.
- [Update external link](https://docs.gennia.ai/api-reference/hub-external-links/update-external-link.md): Partial update of title and/or url. Empty body returns 200 with the link unchanged.
- [Delete hub logo](https://docs.gennia.ai/api-reference/hub/delete-hub-logo.md): Removes the logo for the given type (clears the path and deletes the file from storage). Idempotent: removing an already-empty logo returns 200 with the hub unchanged.
- [Get hub](https://docs.gennia.ai/api-reference/hub/get-hub.md): Returns the hub bound to the API key's workspace. Creates one on demand if it doesn't exist yet (idempotent).
- [Update hub identity](https://docs.gennia.ai/api-reference/hub/update-hub-identity.md): Partial update of identity fields: name, description, theme, colors, support. Access settings live under /hub/access and domain under /hub/domain. Sending only the fields you want to change is enough; null/absent fields are not touched.
- [Upload hub logo](https://docs.gennia.ai/api-reference/hub/upload-hub-logo.md): Uploads a logo image. Same endpoint serves all variants — identity pages use `horizontal`, `icon`, `email`; the Access page uses `banner`. Replaces any existing logo for that type and deletes the old file from storage. Uploading a `horizontal` or `icon` triggers a Stripe branding sync.
- [Create a text-input knowledge source](https://docs.gennia.ai/api-reference/knowledge-sources/create-a-text-input-knowledge-source.md): JSON body with {name, description, sourceType="text_input", textContent} (text up to 1MB). Returns immediately with processingStatus=PENDING; poll GET /{id} until COMPLETED.
- [Delete (soft) a knowledge source](https://docs.gennia.ai/api-reference/knowledge-sources/delete-soft-a-knowledge-source.md)
- [Get a knowledge source](https://docs.gennia.ai/api-reference/knowledge-sources/get-a-knowledge-source.md)
- [List knowledge sources](https://docs.gennia.ai/api-reference/knowledge-sources/list-knowledge-sources.md)
- [Rename / update knowledge source (name, description)](https://docs.gennia.ai/api-reference/knowledge-sources/rename-update-knowledge-source-name-description.md)
- [Send agent message (SSE stream)](https://docs.gennia.ai/api-reference/messages/send-agent-message-sse-stream.md): Same body shape as the sync endpoint. Returns a Server-Sent Events stream. Inspect the `conversation-id` event for the conversation public ID, accumulate `text-delta` events for the reply text, and the `debug-info` event surfaces tokens, model and cost. Pre-flight failures (insufficient ops, agent n…
- [Send agent message (sync)](https://docs.gennia.ai/api-reference/messages/send-agent-message-sync.md): Synchronously sends a message to the agent's published version and blocks until the agent finishes (or `timeoutSeconds` expires). Auto-creates a conversation when `conversationId` is omitted. Response includes token usage and cost.
- [Get Native MCP trigger schema](https://docs.gennia.ai/api-reference/native-mcp-triggers/get-native-mcp-trigger-schema.md): Returns the provider's schema for the trigger, including the configSchema clients use when creating an Automation with triggerMode=NATIVE_MCP_TRIGGER.
- [List Native MCP triggers for a toolkit](https://docs.gennia.ai/api-reference/native-mcp-triggers/list-native-mcp-triggers-for-a-toolkit.md): Returns the trigger types available for the given Composio toolkit (e.g. gmail, slack).
- [Public API health check](https://docs.gennia.ai/api-reference/public-api/public-api-health-check.md): Validates API key authentication and returns the workspace scope bound to the key.
- [Delete (soft) a skill](https://docs.gennia.ai/api-reference/skills/delete-soft-a-skill.md)
- [Get a skill (with files)](https://docs.gennia.ai/api-reference/skills/get-a-skill-with-files.md)
- [List workspace skills](https://docs.gennia.ai/api-reference/skills/list-workspace-skills.md)
- [Rename / update skill metadata (name, description)](https://docs.gennia.ai/api-reference/skills/rename-update-skill-metadata-name-description.md)
- [Upload a skill (multipart ZIP/.skill/.md)](https://docs.gennia.ai/api-reference/skills/upload-a-skill-multipart-zipskillmd.md): Accepts the same shape as Studio web: a single `file` part containing a ZIP archive, .skill bundle, or a standalone SKILL.md. Frontmatter (`name`, `description`, `license`, `compatibility`, `metadata`, `allowed-tools`) is parsed from SKILL.md and persisted alongside per-file content. Max 10MB.
- [Academy](https://docs.gennia.ai/pt/academy.md): Plataforma de cursos para aprender a tirar o máximo do Gennia Studio
- [Autenticação](https://docs.gennia.ai/pt/api-reference/authentication.md): Autentique requisições com uma API key de workspace. Escopo, formato do header e rotação.
- [CLI](https://docs.gennia.ai/pt/api-reference/cli.md): O comando gennia. Auth, instalação do MCP em 1 comando, e escape hatch direto pra qualquer endpoint da Public API.
- [Erros](https://docs.gennia.ai/pt/api-reference/conventions/errors.md): Status codes, formato do body de erro e os códigos machine-readable que cada endpoint pode retornar.
- [Paginação](https://docs.gennia.ai/pt/api-reference/conventions/pagination.md): Todos os endpoints de listagem usam o mesmo padrão page/limit. A resposta inclui contagens totais para você construir UIs paginadas.
- [Introdução](https://docs.gennia.ai/pt/api-reference/introduction.md): Construa em cima da Gennia. A API pública permite criar agentes, executar conversas, gerenciar clientes e configurar seu hub via código.
- [MCP Server](https://docs.gennia.ai/pt/api-reference/mcp.md): Conecte qualquer cliente AI (Cursor, Claude Code, Claude Desktop, Codex) ao seu workspace Gennia com um servidor MCP. 135 ferramentas, uma por endpoint da Public API.
- [Quickstart](https://docs.gennia.ai/pt/api-reference/quickstart.md): Liste seus agentes, envie uma mensagem, leia a resposta. Cinco minutos do zero a uma integração funcionando.
- [Carteira](https://docs.gennia.ai/pt/cobranca/carteira.md): Conecte sua conta Stripe e acompanhe saldos, pagamentos e saques
- [Cupons](https://docs.gennia.ai/pt/cobranca/cupons.md): Crie códigos de desconto para oferecer aos seus clientes
- [Inadimplência](https://docs.gennia.ai/pt/cobranca/inadimplencia.md): Configure regras automáticas para clientes com pagamento atrasado
- [O que é Cobrança](https://docs.gennia.ai/pt/cobranca/index.md): Gerencie planos, clientes, finanças e pagamentos do seu hub
- [Pacotes de Créditos](https://docs.gennia.ai/pt/cobranca/pacotes-creditos.md): Configure pacotes reutilizáveis de créditos vinculados a planos
- [Planos](https://docs.gennia.ai/pt/cobranca/planos.md): Crie e gerencie planos de assinatura para seus clientes
- [Trial](https://docs.gennia.ai/pt/cobranca/trial.md): Configure período de teste gratuito para novos clientes
- [Widget de Preços](https://docs.gennia.ai/pt/cobranca/widget-precos.md): Customize como os planos aparecem na página de preços do seu hub
- [Conceitos](https://docs.gennia.ai/pt/conceitos.md): Glossário dos termos e conceitos fundamentais do Gennia Studio
- [Clientes](https://docs.gennia.ai/pt/gestao/clientes.md): Gerencie clientes, assinaturas, créditos, usuários e faturas
- [O que é Gestão](https://docs.gennia.ai/pt/gestao/index.md): Acompanhe métricas do hub e gerencie seus clientes
- [Painel](https://docs.gennia.ai/pt/gestao/painel.md): Dashboards com métricas de vendas, financeiro e consumo do seu hub
- [Agentes](https://docs.gennia.ai/pt/guides/agents.md): Visão geral de como criar e configurar agentes de IA no Gennia Studio
- [Automações](https://docs.gennia.ai/pt/guides/automacoes.md): Envie prompts para o agente de forma agendada, via app ou webhook
- [Base de Conhecimento](https://docs.gennia.ai/pt/guides/base-de-conhecimento.md): Faça upload de documentos para que o agente responda com informações reais
- [Canais](https://docs.gennia.ai/pt/guides/canais.md): Conecte seus agentes a canais de comunicação como WhatsApp e Widget
- [Comandos](https://docs.gennia.ai/pt/guides/comandos.md): Defina comandos com / que o agente reconhece e executa
- [Computador](https://docs.gennia.ai/pt/guides/computador.md): Ambiente isolado onde o agente executa código Python com segurança
- [Funcionalidades](https://docs.gennia.ai/pt/guides/funcionalidades.md): Configure comportamentos avançados do agente como follow-up, busca web e áudio
- [Instruções (Prompt)](https://docs.gennia.ai/pt/guides/instrucoes.md): Defina o comportamento do agente com instruções claras e estruturadas
- [Memória](https://docs.gennia.ai/pt/guides/memoria.md): Permita que o agente lembre informações entre conversas
- [Skills](https://docs.gennia.ai/pt/guides/skills.md): Conjuntos de instruções especializadas que o agente consulta conforme necessário
- [Sub-agentes](https://docs.gennia.ai/pt/guides/sub-agentes.md): Delegue tarefas para agentes especializados
- [Tools](https://docs.gennia.ai/pt/guides/tools.md): Conecte seu agente a apps externos e APIs para executar ações
- [Acesso](https://docs.gennia.ai/pt/hub/acesso.md): Defina se o hub é privado ou público e configure o banner de login
- [Domínio](https://docs.gennia.ai/pt/hub/dominio.md): Configure o subdomínio do seu hub e copie as URLs de acesso
- [Identidade](https://docs.gennia.ai/pt/hub/identidade.md): Configure a identidade visual, logos, tema e cores do seu hub
- [O que é o Hub](https://docs.gennia.ai/pt/hub/index.md): O portal white-label com a sua marca onde seus clientes acessam os agentes
- [Links](https://docs.gennia.ai/pt/hub/links.md): Adicione links externos ao seu hub para redes sociais, site ou documentação
- [Notificações](https://docs.gennia.ai/pt/hub/notificacoes.md): Customize os templates de e-mail enviados aos seus clientes
- [Onboarding](https://docs.gennia.ai/pt/hub/onboarding.md): Configure o fluxo de boas-vindas para novos clientes do hub
- [Suporte](https://docs.gennia.ai/pt/hub/suporte.md): Configure o canal de suporte que seus clientes usam para entrar em contato
- [O que é o Gennia Studio](https://docs.gennia.ai/pt/index.md): A plataforma para criar, gerenciar e vender agentes de IA através de hubs white-label
- [Marketplace](https://docs.gennia.ai/pt/marketplace.md): Encontre e use templates de agentes prontos criados pela comunidade
- [Conversando com Agentes](https://docs.gennia.ai/pt/portal/agentes.md): Como interagir com os agentes de IA disponíveis no hub
- [Automações](https://docs.gennia.ai/pt/portal/automacoes.md): Crie fluxos que rodam automaticamente por agendamento ou eventos
- [Caixa de Entrada](https://docs.gennia.ai/pt/portal/caixa-entrada.md): Acompanhe e intervenha nas conversas dos agentes em canais externos
- [Coleções](https://docs.gennia.ai/pt/portal/colecoes.md): Organize suas conversas em pastas personalizadas
- [Dashboard](https://docs.gennia.ai/pt/portal/dashboard.md): Acompanhe métricas de uso dos seus agentes em canais externos
- [Histórico](https://docs.gennia.ai/pt/portal/historico.md): Encontre e retome conversas anteriores com os agentes
- [Home](https://docs.gennia.ai/pt/portal/home.md): A página inicial do hub com agentes, atividade recente e acesso rápido
- [O que é o Hub](https://docs.gennia.ai/pt/portal/index.md): O portal onde você acessa seus agentes de IA e automatiza processos
- [Perfil](https://docs.gennia.ai/pt/portal/perfil.md): Edite suas informações pessoais e gerencie as memórias dos agentes
- [Gestão do Plano](https://docs.gennia.ai/pt/portal/plano.md): Acompanhe créditos, mude de plano e gerencie sua assinatura
- [Primeiros passos](https://docs.gennia.ai/pt/portal/primeiros-passos.md): Entre no hub pela primeira vez e conheça a plataforma
- [Usuários](https://docs.gennia.ai/pt/portal/usuarios.md): Veja e gerencie os clientes finais que interagiram com seus agentes em canais externos
- [Workspace](https://docs.gennia.ai/pt/portal/workspace.md): Configure seu workspace e gerencie os membros do seu time
- [Quickstart](https://docs.gennia.ai/pt/quickstart.md): Crie e publique seu primeiro agente em minutos
- [Workspace](https://docs.gennia.ai/pt/workspace.md): Organize seu time, gerencie membros, API keys e o plano do seu workspace

## OpenAPI Specs

- [openapi](https://docs.gennia.ai/api-reference/openapi.json)

## Optional

- [Acessar Gennia Studio](https://studio.gennia.ai)