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

Agents

Create agents, configure prompts, link tools, skills, knowledge sources and channels.

Conversations

Send messages, stream responses (SSE), list conversations and their messages.

Hub

Manage your hub identity, domain, access policies, external links and clients.

Billing

Configure plans, credit packages, coupons and inspect client subscriptions.

​
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

1

Create an API key

Generate a workspace API key inside Studio. See Authentication.
2

Make your first call

Follow the Quickstart to list agents and send a message in under five minutes.
3

Explore the reference

Every endpoint is documented in the API Reference tab with try-it-out and full schemas.