> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dimedove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get app config

> Returns the app's active configuration and agent settings.



## OpenAPI

````yaml /openapi/apps-api.json get /apps/{app_id}/config
openapi: 3.1.0
info:
  title: Dimedove API
  version: 1.0.0
  description: >-
    Programmatically manage conversations and interact with your AI agents
    through the Dimedove API.
servers:
  - url: https://api.dimedove.com/v1
    description: Production
security: []
paths:
  /apps/{app_id}/config:
    get:
      tags:
        - Applications
      summary: Get app config
      description: Returns the app's active configuration and agent settings.
      operationId: apps_api_get_app_config
      parameters:
        - in: path
          name: app_id
          schema:
            description: The unique identifier of the app.
            title: App Id
            type: string
          required: true
          description: The unique identifier of the app.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppConfigSchema'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenAIErrorSchema'
      security:
        - AppsApiKeyAuth: []
components:
  schemas:
    AppConfigSchema:
      properties:
        app_id:
          description: Unique identifier for the app.
          title: App Id
          type: string
        stream:
          description: >-
            Whether streaming (Server-Sent Events) is enabled by default for
            this app's responses.
          title: Stream
          type: boolean
        generative_ui:
          description: >-
            Whether generative UI is enabled. When true, responses may include
            'data-spec' parts for dynamic UI rendering.
          title: Generative Ui
          type: boolean
        agent:
          $ref: '#/components/schemas/AppConfigAgentSchema'
          description: The AI agent configuration for this app.
      required:
        - app_id
        - stream
        - generative_ui
        - agent
      title: AppConfigSchema
      type: object
    OpenAIErrorSchema:
      properties:
        error:
          $ref: '#/components/schemas/OpenAIErrorDetail'
          description: The error detail object.
      required:
        - error
      title: OpenAIErrorSchema
      type: object
    AppConfigAgentSchema:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: The display name of the AI agent associated with this app.
          title: Name
        config:
          $ref: '#/components/schemas/AppConfigAgentConfigSchema'
          description: The agent's UI configuration settings.
      required:
        - config
      title: AppConfigAgentSchema
      type: object
    OpenAIErrorDetail:
      properties:
        message:
          description: A human-readable description of the error.
          title: Message
          type: string
        type:
          description: >-
            The error type identifier (e.g. 'invalid_api_key', 'not_found',
            'rate_limit_exceeded').
          title: Type
          type: string
        param:
          anyOf:
            - type: string
            - type: 'null'
          description: The parameter that caused the error, if applicable.
          title: Param
        code:
          anyOf:
            - type: string
            - type: 'null'
          description: An error code providing additional detail, if applicable.
          title: Code
      required:
        - message
        - type
      title: OpenAIErrorDetail
      type: object
    AppConfigAgentConfigSchema:
      properties:
        primary_color:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The primary brand color for the agent's UI, as a hex code (e.g.
            '#0f0e0d').
          title: Primary Color
        secondary_color:
          anyOf:
            - type: string
            - type: 'null'
          description: The secondary brand color for the agent's UI, as a hex code.
          title: Secondary Color
      title: AppConfigAgentConfigSchema
      type: object
  securitySchemes:
    AppsApiKeyAuth:
      type: http
      scheme: bearer

````