> ## 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.

# Confirm a filing document upload

> Save the uploaded file to this filing and return its ID and name. Retry the same token before expiry to revalidate and confirm the current uploaded bytes. An unchanged registered file version preserves its index state. Repeating PUT can replace the bytes and completion refreshes indexing. An overlapping completion can return 409; retry the same token. Current filing edit access is required. Schedule assignment is a separate step.



## OpenAPI

````yaml /openapi.json post /insurance/managed-filings/{filingId}/uploads/complete
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://canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /insurance/managed-filings/{filingId}/uploads/complete:
    post:
      tags:
        - Managed Filings
      summary: Confirm a filing document upload
      description: >-
        Save the uploaded file to this filing and return its ID and name. Retry
        the same token before expiry to revalidate and confirm the current
        uploaded bytes. An unchanged registered file version preserves its index
        state. Repeating PUT can replace the bytes and completion refreshes
        indexing. An overlapping completion can return 409; retry the same
        token. Current filing edit access is required. Schedule assignment is a
        separate step.
      operationId: completeManagedFilingUpload
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: filingId
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2ManagedFilingUploadComplete'
      responses:
        '200':
          description: The file is available in this filing’s documents.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ManagedFilingUploadedFile'
        '400':
          description: >-
            Invalid file details, invalid/expired completion token, or
            invalid_upload_content: correct the file and start a new upload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: Filing edit permission required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: Filing not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '409':
          description: >-
            Filing is read-only, uploaded bytes are not ready, or another
            completion changed the file. Retry a concurrent completion after the
            other request finishes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '413':
          description: Request exceeds 32 KiB.
          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: Temporarily unavailable. Retry-After is in seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2ManagedFilingUploadComplete:
      type: object
      properties:
        uploadToken:
          type: string
          minLength: 1
          maxLength: 16384
          description: >-
            Opaque upload token. Return it unchanged to the completion endpoint
            for this filing within one hour.
      required:
        - uploadToken
      additionalProperties: false
    V2ManagedFilingUploadedFile:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: File ID. Use as artifactId when adding a filing item or attachment.
        name:
          type: string
          description: Saved filename, including any suffix added to avoid a collision.
        sizeBytes:
          type: integer
          minimum: 0
        mimeType:
          type: string
      required:
        - id
        - name
        - sizeBytes
        - mimeType
      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.
          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.