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

# Update AI analysis prompt

> Updates an existing prompt configuration by ID. Allows modification of prompt text and trigger settings. Requires `admin.platform.super` permission.



## OpenAPI

````yaml api-reference/ai.yaml post /prompts/update
openapi: 3.0.3
info:
  title: ai
  description: >-
    The AI Service acts as the intelligence hub of the arbitration platform,
    powering smart automation, analysis, and decision support. It centralizes
    all AI integrations, ensuring seamless and consistent AI functionality
    across every part of the system.
  version: 1.0.0
servers:
  - url: https://ai.platform.arb.inc
security: []
tags:
  - name: /
  - name: analysis
  - name: demo
  - name: generate-award
  - name: generate-document
  - name: process
  - name: prompts
paths:
  /prompts/update:
    post:
      tags:
        - prompts
      summary: Update AI analysis prompt
      description: >-
        Updates an existing prompt configuration by ID. Allows modification of
        prompt text and trigger settings. Requires `admin.platform.super`
        permission.
      operationId: updatePrompt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
              properties:
                id:
                  type: integer
                  minimum: 1
                  description: Prompt ID to update
                  example: 42
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 50000
                  description: Updated AI prompt text
                  example: >-
                    Analyze the statement of claim with enhanced focus on
                    damages calculation.
                active:
                  type: boolean
                  description: Whether this prompt is active
                  example: true
                triggerOnDocket:
                  type: boolean
                  description: Trigger analysis when document is docketed
                  example: true
                triggerOnDraft:
                  type: boolean
                  description: Trigger analysis when document is drafted
                  example: false
                includeEvidence:
                  type: boolean
                  description: Include case evidence in analysis context
                  example: true
                includeFullCase:
                  type: boolean
                  description: Include full case docket in analysis context
                  example: false
      responses:
        '200':
          description: Updated prompt details
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    example: 42
                  created:
                    type: string
                    format: date-time
                    example: '2026-01-15T10:30:00.000Z'
                  updated:
                    type: string
                    format: date-time
                    example: '2026-01-20T14:45:00.000Z'
                  documentID:
                    type: string
                    example: statementOfClaim
                  ruleSet:
                    type: string
                    example: small-claims-v1
                  prompt:
                    type: string
                    example: >-
                      Analyze the statement of claim with enhanced focus on
                      damages calculation.
                  active:
                    type: boolean
                    example: true
                  triggerOnDocket:
                    type: boolean
                    example: true
                  triggerOnDraft:
                    type: boolean
                    example: false
                  includeEvidence:
                    type: boolean
                    example: true
                  includeFullCase:
                    type: boolean
                    example: false
        '404':
          description: Prompt not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````