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

# Fix several filing comments

> Ask Effective to fix up to 50 open discussions together. The filing session plans the work, runs fixes in parallel, and asks the requesting user for missing facts or decisions once for the whole request. Each discussion gets its own task, with the same reuse, permission, and retry rules as fixing one comment. If any comment is missing, resolved, or not a discussion message, the request fails and saves no fix tasks or message to the filing session; the filing session itself may already have been set up. Does not stage or submit in SERFF.



## OpenAPI

````yaml /openapi.json post /insurance/managed-filings/{filingId}/comments/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.canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /insurance/managed-filings/{filingId}/comments/fix:
    post:
      tags:
        - Managed Filings
      summary: Fix several filing comments
      description: >-
        Ask Effective to fix up to 50 open discussions together. The filing
        session plans the work, runs fixes in parallel, and asks the requesting
        user for missing facts or decisions once for the whole request. Each
        discussion gets its own task, with the same reuse, permission, and retry
        rules as fixing one comment. If any comment is missing, resolved, or not
        a discussion message, the request fails and saves no fix tasks or
        message to the filing session; the filing session itself may already
        have been set up. Does not stage or submit in SERFF.
      operationId: fixManagedFilingComments
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: filingId
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                commentIds:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 1
                  maxItems: 50
                  description: Top-level comments or replies in the discussions to fix.
              required:
                - commentIds
              additionalProperties: false
      responses:
        '202':
          description: New or existing fix tasks. Open the session to follow progress.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ManagedFilingCommentFixes'
        '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:
    V2ManagedFilingCommentFixes:
      type: object
      properties:
        fixes:
          type: array
          items:
            type: object
            properties:
              commentId:
                type: string
                format: uuid
              taskId:
                type: string
                format: uuid
                description: Task for this fix attempt.
              status:
                type: string
                enum:
                  - open
                  - blocked
              reused:
                type: boolean
                description: True when an existing active task was returned.
            required:
              - commentId
              - taskId
              - status
              - reused
            additionalProperties: false
        sessionId:
          type: string
          description: Filing session that coordinates the fixes.
        sessionUrl:
          type: string
          format: uri
          description: Open this link to answer questions and review the fixes.
      required:
        - fixes
        - 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.