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

# Get the agent's prompt + variables



## OpenAPI

````yaml /api-reference/openapi.json get /public/api/v1/agents/{agentPublicId}/prompt
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/{agentPublicId}/prompt:
    get:
      tags:
        - Agent Prompt
      summary: Get the agent's prompt + variables
      operationId: getPrompt
      parameters:
        - in: path
          name: agentPublicId
          required: true
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicAgentPromptDTO'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicAgentPromptDTO'
          description: Missing or invalid API key
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicAgentPromptDTO'
          description: Agent not found
      security:
        - workspaceApiKey: []
components:
  schemas:
    PublicAgentPromptDTO:
      description: >-
        Aggregated prompt context (systemPrompt + dynamicPromptEnabled +
        variables).
      properties:
        dynamicPromptEnabled:
          type: boolean
        systemPrompt:
          type: string
        variables:
          description: >-
            Dynamic-prompt variables on this agent. Full CRUD lives at
            /variables.
          items:
            $ref: '#/components/schemas/PublicAgentVariableDTO'
          type: array
      type: object
    PublicAgentVariableDTO:
      description: Dynamic-prompt variable definition (per agent).
      properties:
        booleanTextWhenFalse:
          description: Prompt fragment when bool variable is false.
          type: string
        booleanTextWhenTrue:
          description: Prompt fragment when bool variable is true.
          type: string
        createdAt:
          format: date-time
          type: string
        defaultValue:
          $ref: '#/components/schemas/JsonNode'
          description: Default value (shape depends on `type`).
        description:
          type: string
        label:
          description: Display label shown in the Hub form.
          type: string
        multiChoiceSeparator:
          description: Joiner for multi_choice rendered values (default `, `).
          type: string
        name:
          description: Slug used in `{{name}}` references inside the systemPrompt.
          type: string
        options:
          description: Options for single_choice / multi_choice (null otherwise).
          items:
            $ref: '#/components/schemas/Option'
          type: array
        publicId:
          format: uuid
          type: string
        required:
          description: Whether the Hub form must submit this field.
          type: boolean
        sortOrder:
          format: int32
          type: integer
        type:
          enum:
            - text_short
            - text_long
            - number
            - date
            - time
            - datetime
            - single_choice
            - multi_choice
            - bool
          type: string
        updatedAt:
          format: date-time
          type: string
      type: object
    JsonNode:
      type: object
    Option:
      properties:
        injectedText:
          type: string
        label:
          type: string
        publicId:
          format: uuid
          type: string
        sortOrder:
          format: int32
          type: integer
      type: object
  securitySchemes:
    workspaceApiKey:
      in: header
      name: X-Api-Key
      type: apiKey

````