> ## 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. # Create agent > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /public/api/v1/agents openapi: 3.1.0 info: contact: email: support@gennia.ai name: Gennia Support url: https://gennia.ai description: >- Workspace-scoped API authenticated via workspace API key (header `X-Api-Key: gsk_...` or `Authorization: Bearer gsk_...`). title: Gennia Public API version: v1 servers: - description: Production url: https://api.gennia.ai security: - workspaceApiKey: [] tags: - description: Slash commands available inside the agent chat. name: Agent Commands - description: Link skills to an agent. name: Agent Skills - description: Read/rename/delete workspace knowledge sources. name: Knowledge Sources - description: Link knowledge sources to an agent. name: Agent Knowledge Sources - description: Workspace CRUD for HTTP/DB/Custom tools. name: HTTP Tools - description: Read/write the agent's model selection + capabilities. name: Agent Model - description: Discover trigger types available for Native MCP toolkits. name: Native MCP Triggers - description: Discover and toggle capability features. name: Agent Features - description: Hub access settings. name: Hub Access - description: Read conversation history and delete conversations. name: Conversations - description: Send messages to a published agent. name: Messages - description: Workspace CRUD for External MCP servers. name: External MCPs - description: Hub billing — plans, coupons, credit packages. name: Billing - description: External links shown in the hub menu. name: Hub External Links - description: Link Native MCP (Composio) instances to an agent. name: Agent Native MCPs - description: Manage AI agents in the workspace bound to the API key. name: Agents - description: Read published version snapshots and restore. name: Agent Versions - description: Read/rename/delete workspace skills. name: Skills - description: Manage hub end-customers (client workspaces). name: Clients - description: Hub domain (subdomain) management. name: Hub Domain - description: Read/write the agent's prompt context. name: Agent Prompt - description: Scheduled / trigger-based runs of an agent. name: Agent Automations - description: Link HTTP/DB/Custom tools to an agent. name: Agent HTTP Tools - description: Hub identity, branding, logos and overall configuration. name: Hub - description: Discover AI models available to this workspace. name: AI Models - description: Discover channel types and their config schemas. name: Channel Types - description: Connect agents to messaging surfaces. name: Agent Channels - description: Link workspace-registered External MCP servers to an agent. name: Agent External MCPs - description: Workspace-scoped public API (API key authentication) name: Public API - description: Dynamic-prompt variable definitions. name: Agent Variables - description: Link sub-agents as delegation targets. name: Agent Sub-agents paths: /public/api/v1/agents: post: tags: - Agents summary: Create agent description: >- 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. operationId: createAgent requestBody: content: application/json: schema: $ref: '#/components/schemas/CreatePublicAgentDTO' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/PublicAgentDTO' description: Created '400': content: application/json: schema: $ref: '#/components/schemas/PublicAgentDTO' description: Validation failed / invalid avatar URL '401': content: application/json: schema: $ref: '#/components/schemas/PublicAgentDTO' description: Missing or invalid API key '409': content: application/json: schema: $ref: '#/components/schemas/PublicAgentDTO' description: Agent name already taken in this workspace '422': content: application/json: schema: $ref: '#/components/schemas/PublicAgentDTO' description: Avatar fetch failed / agent limit reached security: - workspaceApiKey: [] components: schemas: CreatePublicAgentDTO: description: Body for creating a new agent in the workspace. properties: avatarUrl: description: Optional avatar URL (http or https). example: https://cdn.example.com/avatars/support-bot.png maxLength: 1024 minLength: 0 pattern: ^https?://.+ type: string categories: description: >- Up to 10 free-form category tags. Each tag must not exceed 100 characters. example: - support - billing items: maxLength: 100 minLength: 0 type: string maxItems: 10 minItems: 0 type: array description: description: Short description shown in the agent catalogue. example: Answers questions about billing, refunds and account access. maxLength: 2000 minLength: 0 type: string name: description: Display name of the agent. example: Support Bot maxLength: 150 minLength: 1 type: string type: object PublicAgentDTO: description: Agent metadata + editable-state configuration. properties: aiModelName: description: Selected AI model display name; null when not yet configured. type: string aiModelPublicId: description: Selected AI model public ID; null when not yet configured. format: uuid type: string audioListeningEnabled: type: boolean audioResponseEnabled: type: boolean avatarUrl: type: string categories: items: type: string type: array createdAt: format: date-time type: string description: type: string draftVersionNumber: format: int32 type: integer dynamicPromptEnabled: type: boolean followUpAfterHours: format: int32 type: integer followUpBusinessHoursEnd: example: '14:30:00' type: string followUpBusinessHoursStart: example: '14:30:00' type: string followUpEnabled: type: boolean followUpInactivityMinutes: format: int32 type: integer followUpIntervalMinutes: format: int32 type: integer followUpMaxAttempts: format: int32 type: integer followUpPrompt: type: string genuiEnabled: type: boolean hasExternalChannel: type: boolean hasUnpublishedChanges: description: True if the editable state differs from the published snapshot. type: boolean longTermMemoryEnabled: type: boolean memoryCustomInstructions: type: string messageDelayEnabled: type: boolean messageDelayType: description: Delay tier when messageDelayEnabled=true. enum: - LOW - MEDIUM - HIGH - RANDOM type: string messageSplittingEnabled: type: boolean name: type: string publicId: format: uuid type: string publishedVersionNumber: format: int32 type: integer sandboxEnabled: type: boolean status: enum: - draft - active - inactive - archived type: string systemPrompt: type: string temperature: format: float type: number thinkingEffort: description: Thinking effort tier. enum: - low - medium - high type: string thinkingEnabled: type: boolean ttsVoice: type: string updatedAt: format: date-time type: string webSearchEnabled: type: boolean type: object securitySchemes: workspaceApiKey: in: header name: X-Api-Key type: apiKey ````