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

# Validate Assistant configuration without creating a thread.

> Read-only validation of persisted instructions, context, strict response schema, selected tools and approval policies against current admission.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/assistant/configuration/validate
openapi: 3.0.0
info:
  title: RevoEngine Platform API
  description: Official RevoEngine Platform API documentation.
  version: 1.7.0
  contact:
    name: Support
    email: support@revoengine.com
  termsOfService: https://docs.revoengine.com/tos
servers:
  - url: https://api.revoengine.com
    description: Production
security: []
tags:
  - name: Accounts
    description: Users, service accounts, API keys, status, and platform access.
    externalDocs:
      description: Identity and access guide
      url: https://docs.revoengine.com/operate/identity-and-access
  - name: Activity
    description: Snapshot-backed activity and version history.
    externalDocs:
      description: Observability guide
      url: https://docs.revoengine.com/operate/observability
  - name: Agent Memory
    description: Administrative access to durable Agent memory.
    externalDocs:
      description: Agent memory and workspaces guide
      url: https://docs.revoengine.com/ai/memory-and-workspaces
  - name: Agent Plugins
    description: Agent plugin definitions, synchronization, testing, and lifecycle.
    externalDocs:
      description: Agent plugins guide
      url: https://docs.revoengine.com/ai/plugins
  - name: Agent Terminals
    description: Terminal pairing, owner grants, access, and command activity.
    externalDocs:
      description: Connect a terminal guide
      url: https://docs.revoengine.com/ai/terminals
  - name: Agents
    description: >-
      Agent definitions, runs, sessions, inboxes, memory, tools, workspaces, and
      lifecycle.
    externalDocs:
      description: Autonomous Agents guide
      url: https://docs.revoengine.com/ai/agents
  - name: Assistant
    description: >-
      Assistant threads, messages, responses, goals, reports, sharing,
      attachments, and control.
    externalDocs:
      description: Assistant guide
      url: https://docs.revoengine.com/ai/assistant
  - name: Automation
    description: >-
      Jobs, templates, schedules, events, webhooks, execution history, and
      lifecycle.
    externalDocs:
      description: Automation guide
      url: https://docs.revoengine.com/operate/automation
  - name: Browser Profiles
    description: >-
      Manage browser profile metadata, access, assignments and active sessions
      without exposing website authentication state.
    externalDocs:
      description: Browser profiles and collaboration guide
      url: https://docs.revoengine.com/ai/browser
  - name: Chat
    description: Collaborative chat threads, messages, reactions, uploads, and attachments.
    externalDocs:
      description: Team Chat guide
      url: https://docs.revoengine.com/operate/chat
  - name: Component deployments
    description: >-
      Custom Node.js runtime deployment attempts, readiness, activation, and
      rollback.
    externalDocs:
      description: Custom Node.js guide
      url: https://docs.revoengine.com/build/custom-nodejs
  - name: Components
    description: Components, elements, versions, validation, activation, and lifecycle.
    externalDocs:
      description: Components guide
      url: https://docs.revoengine.com/build/components
  - name: Config
    description: Instance configuration, usage, logs, and cache administration.
    externalDocs:
      description: Instance settings guide
      url: https://docs.revoengine.com/platform/instance-settings
  - name: Database Cache
    description: Instance Database cache values and statistics.
    externalDocs:
      description: Database Cache guide
      url: https://docs.revoengine.com/operate/database-cache
  - name: Database Views
    description: Database Views, previews, refreshes, exports, and controlled data actions.
    externalDocs:
      description: Database Views guide
      url: https://docs.revoengine.com/operate/database-views
  - name: Databases
    description: Database definitions, data, audits, exports, cloning, and lifecycle.
    externalDocs:
      description: Databases guide
      url: https://docs.revoengine.com/operate/databases
  - name: Endpoints
    description: >-
      Endpoint definitions, activation, validation, generated OpenAPI, and
      statistics.
    externalDocs:
      description: Endpoints guide
      url: https://docs.revoengine.com/operate/endpoints
  - name: Files
    description: Compatibility file listing, preview, download, and deletion operations.
    externalDocs:
      description: Files compatibility guide
      url: https://docs.revoengine.com/operate/files
  - name: Groups
    description: Groups, membership, avatars, and lifecycle.
    externalDocs:
      description: Groups guide
      url: https://docs.revoengine.com/operate/groups
  - name: Instance Vault
    description: Operations in the Instance Vault Platform API domain.
    externalDocs:
      description: Secrets and Vault guide
      url: https://docs.revoengine.com/operate/secrets
  - name: Me
    description: Current user profile, keys, avatar, and session information.
    externalDocs:
      description: Authentication guide
      url: https://docs.revoengine.com/developers/authentication
  - name: Native tests
    description: Operations in the Native tests Platform API domain.
    externalDocs:
      description: Native tests guide
      url: https://docs.revoengine.com/build/native-tests
  - name: Observability
    description: Authorized execution, performance, graph, and log evidence.
    externalDocs:
      description: Observability guide
      url: https://docs.revoengine.com/operate/observability
  - name: Preferences
    description: User and instance preference values.
    externalDocs:
      description: Platform UI guide
      url: https://docs.revoengine.com/platform/ui-tour
  - name: Role Groups
    description: Role groups, members, assigned roles, and lifecycle.
    externalDocs:
      description: Permissions guide
      url: https://docs.revoengine.com/operate/permissions
  - name: Roles
    description: Available platform roles and role details.
    externalDocs:
      description: Permissions guide
      url: https://docs.revoengine.com/operate/permissions
  - name: Search
    description: Cross-domain search over objects visible to the caller.
    externalDocs:
      description: Search and discovery guide
      url: https://docs.revoengine.com/platform/search
  - name: Secrets
    description: >-
      Secret definitions, revision history, explicit rotation, activation,
      reveal, disable, and destruction.
    externalDocs:
      description: Secrets guide
      url: https://docs.revoengine.com/operate/secrets
  - name: Share
    description: >-
      Short-lived authenticated links to supported application routes and grid
      state.
    externalDocs:
      description: Platform API share-link guide
      url: >-
        https://docs.revoengine.com/developers/platform-api#share-application-context
  - name: Storage
    description: >-
      Storage workspaces, folders, objects, upload sessions, signed access, and
      lifecycle.
    externalDocs:
      description: Storage guide
      url: https://docs.revoengine.com/operate/storage
  - name: Studio
    description: >-
      Manage durable Studio coding sessions, participants, shared discussion,
      tests, review and explicitly activated releases. Available only on enabled
      instances.
    externalDocs:
      description: Studio sessions guide
      url: https://docs.revoengine.com/build/studio-sessions
externalDocs:
  description: Documentation
  url: https://docs.revoengine.com
paths:
  /api/v1/assistant/configuration/validate:
    post:
      tags:
        - Assistant
      summary: Validate Assistant configuration without creating a thread.
      description: >-
        Read-only validation of persisted instructions, context, strict response
        schema, selected tools and approval policies against current admission.
      operationId: AssistantController_validateConfiguration
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssistantConfigurationDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssistantConfigurationValidationDto'
        '400':
          description: >-
            Invalid configuration; field and JSON pointer path are included for
            semantic errors.
      security:
        - bearer: []
components:
  schemas:
    AssistantConfigurationDto:
      type: object
      properties:
        instructions:
          type: string
          maxLength: 16000
          description: >-
            Instructions persisted on this thread across follow-up messages,
            Resume, same-owner forks and compaction. Maximum 16 KiB UTF-8 and 16
            KiB after safe instruction rendering. Supplements mandatory runtime
            and instance-global instructions; never grants tool permissions.
            Immutable after creation.
        contextMode:
          type: string
          enum:
            - platform
            - minimal
          description: >-
            Persisted context profile. platform preserves the normal Revo
            Assistant. minimal keeps instance-global and account standing
            instructions and safety, omits automatic memory and plugin
            discovery/preload, and admits only explicitly selected
            tools/plugins. Defaults to platform. Immutable after creation.
        responseFormat:
          description: >-
            Persisted final-answer format, also enforced on browser follow-ups
            and Resume. Defaults to text. Immutable after creation.
          allOf:
            - $ref: '#/components/schemas/AssistantResponseFormatDto'
        permissions:
          type: string
          description: >-
            Per-turn approval policy. default requires approval for
            side-effecting tool calls, auto_review uses conditional safe
            auto-review, and full skips normal approval gates.
          enum:
            - default
            - auto_review
            - full
          default: default
        toolPermissions:
          type: object
          description: >-
            Optional per-tool approval policy overrides. Runtime sanitizes keys
            and enum values before persisting them.
          additionalProperties:
            enum:
              - default
              - auto_review
              - full
        toolNames:
          type: array
          description: >-
            Optional allowlist of operational tool names for this turn. Omit to
            allow the gateway default surface; pass an empty array to admit no
            tools for direct-answer turns.
          items:
            type: string
            enum:
              - ref_search
              - ref_describe
              - ref_apply
              - snapshot_get
              - snapshot_history
              - snapshot_diff
              - storage
              - skill_search
              - skill_load
              - memory_search
              - memory_load
              - memory_save
              - plan_update
              - code_search
              - code_read
              - code_exec
              - ops_investigate
              - platform_api_find_operation
              - dependency_graph
              - web_search
              - web_load
              - web_rich_lookup
              - wait
              - conversation_search
              - conversation_load
              - attachment_load
              - send_message
              - agent_handoff
              - agent_delegate
              - plugin_search
              - plugin_load
              - plugin_call
              - request_clarification
              - code_describe
              - generate_widget
              - terminal_exec
              - terminal
              - studio
              - tool_exec
              - tool_wait
              - tool_status
              - tool_cancel
        pluginIds:
          description: Optional registry plugin ids attached to this assistant turn.
          type: array
          items:
            type: string
            format: uuid
    AssistantConfigurationValidationDto:
      type: object
      properties:
        valid:
          type: boolean
          enum:
            - true
        normalized:
          $ref: '#/components/schemas/AssistantConfigurationDto'
        toolNames:
          type: array
          nullable: true
          description: null means default selection; an empty array means no tools.
          items:
            type: string
            enum:
              - ref_search
              - ref_describe
              - ref_apply
              - snapshot_get
              - snapshot_history
              - snapshot_diff
              - storage
              - skill_search
              - skill_load
              - memory_search
              - memory_load
              - memory_save
              - plan_update
              - code_search
              - code_read
              - code_exec
              - ops_investigate
              - platform_api_find_operation
              - dependency_graph
              - web_search
              - web_load
              - web_rich_lookup
              - wait
              - conversation_search
              - conversation_load
              - attachment_load
              - send_message
              - agent_handoff
              - agent_delegate
              - plugin_search
              - plugin_load
              - plugin_call
              - request_clarification
              - code_describe
              - generate_widget
              - terminal_exec
              - terminal
              - studio
              - tool_exec
              - tool_wait
              - tool_status
              - tool_cancel
        effectiveToolNames:
          type: array
          items:
            type: string
            enum:
              - ref_search
              - ref_describe
              - ref_apply
              - snapshot_get
              - snapshot_history
              - snapshot_diff
              - storage
              - skill_search
              - skill_load
              - memory_search
              - memory_load
              - memory_save
              - plan_update
              - code_search
              - code_read
              - code_exec
              - ops_investigate
              - platform_api_find_operation
              - dependency_graph
              - web_search
              - web_load
              - web_rich_lookup
              - wait
              - conversation_search
              - conversation_load
              - attachment_load
              - send_message
              - agent_handoff
              - agent_delegate
              - plugin_search
              - plugin_load
              - plugin_call
              - request_clarification
              - code_describe
              - generate_widget
              - terminal_exec
              - terminal
              - studio
              - tool_exec
              - tool_wait
              - tool_status
              - tool_cancel
      required:
        - valid
        - normalized
        - toolNames
        - effectiveToolNames
    AssistantResponseFormatDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - text
            - json
          description: >-
            Final answer format. JSON without a schema requires a JSON object;
            with a schema it uses strict Structured Outputs. Defaults to text.
        schema:
          type: object
          additionalProperties: true
          description: >-
            Optional strict JSON Schema for a JSON object response. All object
            properties must be required and additionalProperties must be false.
            Only local schema references are allowed. Maximum 32 KiB.
        strict:
          type: boolean
          enum:
            - true
          description: >-
            Schema responses are always strict. Defaults to true when schema is
            supplied; false and strict without a schema are rejected.
      required:
        - type
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      description: Bearer JWT token or API Key (sk-*).
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.