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

# Fix a filing comment

> Ask Effective to fix an open discussion. Requires a write-capable organization member credential and filing edit access. Uses the filing session and asks the requesting user for missing facts or decisions. Effective resolves the discussion only after applying and verifying a correction. Does not stage or submit in SERFF. Concurrent requests for messages in the same discussion reuse its open or blocked task. After a task completes or closes, another request starts a new task if the discussion is still open. Resolved discussions return 409. After an uncertain response or 503, repeat this request to resume the saved task. Follow sessionUrl to answer questions and review progress; acceptance is not evidence that the comment has been fixed.



## OpenAPI

````yaml /openapi.json post /insurance/managed-filings/{filingId}/comments/{commentId}/fix
openapi: 3.0.3
info:
  title: Effective API
  version: 2.0.0
  description: The public Effective REST API. Authenticate using an Effective API key.
servers:
  - url: https://api.effectiveai.app/api/v2
    description: Production
security:
  - bearerAuth: []
paths:
  /insurance/managed-filings/{filingId}/comments/{commentId}/fix:
    post:
      tags:
        - Managed Filings
      summary: Fix a filing comment
      description: >-
        Ask Effective to fix an open discussion. Requires a write-capable
        organization member credential and filing edit access. Uses the filing
        session and asks the requesting user for missing facts or decisions.
        Effective resolves the discussion only after applying and verifying a
        correction. Does not stage or submit in SERFF. Concurrent requests for
        messages in the same discussion reuse its open or blocked task. After a
        task completes or closes, another request starts a new task if the
        discussion is still open. Resolved discussions return 409. After an
        uncertain response or 503, repeat this request to resume the saved task.
        Follow sessionUrl to answer questions and review progress; acceptance is
        not evidence that the comment has been fixed.
      operationId: fixManagedFilingComment
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: filingId
          in: path
        - schema:
            type: string
            format: uuid
          required: true
          name: commentId
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
              additionalProperties: false
      responses:
        '202':
          description: >-
            New or existing fix task. Open the session to follow progress and
            answer questions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ManagedFilingCommentFix'
        '400':
          description: Invalid fields or request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: A write-capable user credential and edit access are required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: >-
            Filing, item, reference, or registered record type is missing or
            inaccessible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '409':
          description: >-
            Read-only filing, occupied schedule position, dependency, or
            concurrent change.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '415':
          description: Content-Type must be application/json.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: Dependency temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2ManagedFilingCommentFix:
      type: object
      properties:
        taskId:
          type: string
          format: uuid
          description: Task for this fix attempt.
        status:
          type: string
          enum:
            - open
            - blocked
          description: >-
            open means pending or active; blocked means the task needs
            information or cannot currently proceed.
        reused:
          type: boolean
          description: True when an existing active task was returned.
        sessionId:
          type: string
          description: Filing session where the fix is discussed.
        sessionUrl:
          type: string
          format: uri
          description: Open this link to answer questions and review the fix.
      required:
        - taskId
        - status
        - reused
        - sessionId
        - sessionUrl
      additionalProperties: false
    V2CodedError:
      allOf:
        - $ref: '#/components/schemas/V2Error'
        - type: object
          properties:
            code:
              type: string
              minLength: 1
              description: Stable error code. Clients must tolerate unknown future codes.
            details:
              type: array
              items:
                type: object
                properties:
                  location:
                    type: string
                    enum:
                      - path
                      - query
                      - header
                      - body
                  path:
                    type: array
                    items:
                      type: string
                      maxLength: 64
                    maxItems: 12
                  code:
                    type: string
                    enum:
                      - required
                      - invalid_type
                      - invalid_value
                      - unknown_field
                  message:
                    type: string
                    minLength: 1
                    maxLength: 200
                required:
                  - location
                  - path
                  - code
                  - message
              minItems: 1
              maxItems: 20
              description: Bounded safe validation issues; may omit some invalid fields.
            requestId:
              type: string
              minLength: 1
              maxLength: 128
              description: >-
                Existing server correlation for this HTTP attempt, when
                available.
            dataset:
              type: string
              enum:
                - naic
              description: Dataset needed for dataset_not_enabled.
          required:
            - code
    V2Error:
      type: object
      properties:
        error:
          type: string
          minLength: 1
          description: Human-readable explanation of the failure.
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Effective API key. Send Authorization: Bearer sk-eai-...'

````

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