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

# Upload a new version of an attachment



## OpenAPI

````yaml POST /api/v1/internal/attachments/{attachmentId}
openapi: 3.1.0
info:
  title: Risk Cloud API
  description: >-
    The Risk Cloud API is a collection of RESTful API endpoints that empower you
    and your team to directly integrate, automate, and build with the Risk
    Cloud. Risk Cloud API endpoint payloads are JSON based, with some endpoints
    supporting exports in CSV and XSLX formats for flexible integration.


    This API documentation showcases our Risk Cloud API v1, containing a variety
    of endpoints with continued support for enabling integrations with the Risk
    Cloud.


    Visit the [LogicGate Risk Cloud Developer
    Portal](https://www.logicgate.com/developer/) to get started with building
    your custom integration with quick start guides, usage guides, release
    notes, and more. Or download the [v1 OpenAPI
    specification](/legacy-openapi.json).


    Explore our [Risk Cloud API v2](https://docs.logicgate.com/v2/index.html)
    endpoints and documentation as well. [Risk Cloud API
    v2](https://docs.logicgate.com/v2/index.html) is our collection of API-First
    endpoints that are tailor made for our developer users, offer concise and
    highly documented details, are supported by a [Postman
    collection](https://www.postman.com/logicgate-postman/workspace/logicgate-risk-cloud-api/collection/29257227-de8d264b-6eeb-4177-bea6-2da0a8cabffc)
    and [v2 OpenAPI specification](https://github.com/LogicGateTech/openapi),
    and contain our latest API endpoint releases.
  contact:
    name: developer-relations@logicgate.com
    email: developer-relations@logicgate.com
  version: v2026.11.0
servers:
  - url: https://{subdomain}.logicgate.com
    description: Your Risk Cloud environment.
    variables:
      subdomain:
        description: Your Risk Cloud environment's subdomain (e.g. `qa`).
        default: your-instance
security:
  - ApiToken: []
  - basic: []
tags:
  - name: Authentication
    description: >-
      Getting Started: How to create an [API Access
      Token](https://www.logicgate.com/developer/risk-cloud-api-authentication/)
      to begin integrating with the Risk Cloud API
  - name: Attachment
    description: Endpoints for uploading, downloading, and retrieving record attachments.
  - name: Field
    description: Endpoints for creating, updating, and querying fields.
  - name: Principal
    description: >-
      Endpoints for the authenticated principal to view and manage their own
      details.
  - name: Record Audit
    description: Endpoints for retrieving record audit history and productivity data.
  - name: Step
    description: Endpoints for retrieving steps and the steps a user can access.
  - name: Table Report
    description: Endpoints for retrieving and managing table reports.
  - name: User Group
    description: Endpoints for managing user groups and their membership.
externalDocs:
  description: Developer Portal
  url: https://www.logicgate.com/developer/
paths:
  /api/v1/internal/attachments/{attachmentId}:
    post:
      tags:
        - Attachment
      summary: Upload a new version of an attachment.
      operationId: createVersion
      parameters:
        - name: attachmentId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
              required:
                - file
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/AttachmentVersion_ExtendedCurrentValueSummary
components:
  schemas:
    AttachmentVersion_ExtendedCurrentValueSummary:
      type: object
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        awsS3Bucket:
          type: string
        s3Directory:
          type: string
          enum:
            - AI_FILES
            - ALM
            - ATTACHMENT
            - ATTACHMENTS
            - METADATA
            - PROFILE_PICTURE
            - ACCOUNT_PICTURE
            - UPLOADS
            - BATCH_RECORD_IMPORT
            - BULK_LINK_RECORDS
            - IMPORT_FILES
            - IMPORT_VALIDATION
            - TR_EXPORT
            - VR_EXPORT
        awsS3Key:
          type: string
        contentType:
          type: string
        fileSize:
          type: integer
          format: int64
        fileExtension:
          type: string
        awsVersionId:
          type: string
        fileName:
          type: string
        user:
          $ref: '#/components/schemas/User_ExtendedCurrentValueSummary'
      required:
        - active
        - awsS3Bucket
        - awsS3Key
        - awsVersionId
        - contentType
        - created
        - fileExtension
        - fileName
        - fileSize
        - id
        - s3Directory
        - updated
        - user
    User_ExtendedCurrentValueSummary:
      allOf:
        - $ref: '#/components/schemas/CurrentValue_ExtendedCurrentValueSummary'
        - type: object
          properties:
            email:
              type: string
            company:
              type: string
            imageUrl:
              type: string
            status:
              type: string
            tier:
              type: string
              enum:
                - PRIMARY
                - SECONDARY
                - LIMITED
            pricingUserTier:
              type: string
              enum:
                - STANDARD
                - POWER
            mfaEnabled:
              type: boolean
            mfaSetup:
              type: boolean
            autoprovisioned:
              type: boolean
            scimStatus:
              type: string
            automatedUser:
              type: boolean
            automatedUserFieldLabels:
              type: array
              items:
                type: string
            lastLogin:
              $ref: '#/components/schemas/AccessAudit_ExtendedCurrentValueSummary'
            lastDeactivated:
              type: string
              format: date-time
            external:
              type: boolean
            disabled:
              type: boolean
            serviceAccount:
              type: boolean
            superUser:
              type: boolean
            name:
              type: string
            locked:
              type: boolean
      description: Entity for storing all information pertaining to a user.
      discriminator:
        propertyName: status
      oneOf:
        - description: Circular reference to Active_ExtendedCurrentValueSummary
        - description: >-
            And other types: Automated_ExtendedCurrentValueSummary,
            Disabled_ExtendedCurrentValueSummary,
            External_ExtendedCurrentValueSummary,
            Locked_ExtendedCurrentValueSummary,
            Service_ExtendedCurrentValueSummary
      properties:
        status:
          type: string
      required:
        - status
    CurrentValue_ExtendedCurrentValueSummary:
      type: object
      description: Entity used to manage record's field data.
      discriminator:
        propertyName: discriminator
      oneOf:
        - $ref: '#/components/schemas/CurrentCommonValue_ExtendedCurrentValueSummary'
        - description: >-
            And other types: CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary,
            CurrentCommonValue_ExtendedCurrentValueSummary,
            CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            LabelValue_ExtendedCurrentValueSummary,
            CleanAttachment_ExtendedCurrentValueSummary,
            DirtyAttachment_ExtendedCurrentValueSummary,
            PendingAttachment_ExtendedCurrentValueSummary,
            CurrentGoogleAttachmentValue_ExtendedCurrentValueSummary,
            CurrentSharepointAttachmentValue_ExtendedCurrentValueSummary,
            Active_ExtendedCurrentValueSummary,
            Automated_ExtendedCurrentValueSummary,
            Disabled_ExtendedCurrentValueSummary,
            External_ExtendedCurrentValueSummary,
            Locked_ExtendedCurrentValueSummary,
            Service_ExtendedCurrentValueSummary,
            CurrentNumericRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        valueType:
          type: string
        discriminator:
          type: string
        textValue:
          type: string
        numericValue:
          type: number
          format: double
        isDefault:
          type: boolean
        archived:
          type: boolean
        priority:
          type: integer
          format: int32
        field:
          type: string
          description: field
        userGroup:
          type: string
          description: usergroup
        fieldId:
          type: string
        idOrTransientId:
          type: string
        transientIdOrId:
          type: string
        textOrNumericValue:
          type: string
        empty:
          type: boolean
      required:
        - active
        - archived
        - created
        - discriminator
        - field
        - id
        - isDefault
        - numericValue
        - priority
        - textValue
        - updated
        - userGroup
        - valueType
    AccessAudit_ExtendedCurrentValueSummary:
      type: object
      description: Entity used to track authentication attempts.
      discriminator:
        propertyName: accessType
      oneOf:
        - $ref: '#/components/schemas/LogIn_ExtendedCurrentValueSummary'
        - description: >-
            And other types: LogOut_ExtendedCurrentValueSummary,
            LogInFail_ExtendedCurrentValueSummary,
            CredentialsRolled_ExtendedCurrentValueSummary,
            TokenRolled_ExtendedCurrentValueSummary,
            LogIn_ExtendedCurrentValueSummary,
            LogOut_ExtendedCurrentValueSummary,
            LogInFail_ExtendedCurrentValueSummary,
            CredentialsRolled_ExtendedCurrentValueSummary,
            TokenRolled_ExtendedCurrentValueSummary
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        accessType:
          type: string
      required:
        - accessType
        - active
        - created
        - id
        - updated
    CurrentCommonValue_ExtendedCurrentValueSummary:
      allOf:
        - description: Circular reference to CurrentValue_ExtendedCurrentValueSummary
        - $ref: >-
            #/components/schemas/CurrentValueCurrentValueObject_ExtendedCurrentValueSummary
        - $ref: '#/components/schemas/CurrentValueObject_ExtendedCurrentValueSummary'
      required:
        - description
        - guidance
    LogIn_ExtendedCurrentValueSummary:
      allOf:
        - description: Circular reference to AccessAudit_ExtendedCurrentValueSummary
      required:
        - accessType
    CurrentValueCurrentValueObject_ExtendedCurrentValueSummary:
      type: object
      description: Entity used to manage record's field data.
      discriminator:
        propertyName: discriminator
      oneOf:
        - description: Circular reference to CurrentCommonValue_ExtendedCurrentValueSummary
        - description: >-
            And other types: CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary,
            CurrentCommonValue_ExtendedCurrentValueSummary,
            CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            LabelValue_ExtendedCurrentValueSummary,
            CleanAttachment_ExtendedCurrentValueSummary,
            DirtyAttachment_ExtendedCurrentValueSummary,
            PendingAttachment_ExtendedCurrentValueSummary,
            CurrentGoogleAttachmentValue_ExtendedCurrentValueSummary,
            CurrentSharepointAttachmentValue_ExtendedCurrentValueSummary,
            Active_ExtendedCurrentValueSummary,
            Automated_ExtendedCurrentValueSummary,
            Disabled_ExtendedCurrentValueSummary,
            External_ExtendedCurrentValueSummary,
            Locked_ExtendedCurrentValueSummary,
            Service_ExtendedCurrentValueSummary,
            CurrentNumericRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        valueType:
          type: string
        discriminator:
          type: string
        textValue:
          type: string
        numericValue:
          type: number
          format: double
        isDefault:
          type: boolean
        archived:
          type: boolean
        priority:
          type: integer
          format: int32
        field:
          type: string
          description: field
        userGroup:
          type: string
          description: usergroup
        fieldId:
          type: string
        idOrTransientId:
          type: string
        transientIdOrId:
          type: string
        textOrNumericValue:
          type: string
        empty:
          type: boolean
      required:
        - active
        - archived
        - created
        - discriminator
        - field
        - id
        - isDefault
        - numericValue
        - priority
        - textValue
        - updated
        - userGroup
        - valueType
    CurrentValueObject_ExtendedCurrentValueSummary:
      type: object
      description: Entity used to manage record's field data.
      discriminator:
        propertyName: discriminator
      oneOf:
        - description: Circular reference to CurrentCommonValue_ExtendedCurrentValueSummary
        - description: >-
            And other types: CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary,
            CurrentCommonValue_ExtendedCurrentValueSummary,
            CurrentDateValue_ExtendedCurrentValueSummary,
            CurrentDateRangeValue_ExtendedCurrentValueSummary,
            LabelValue_ExtendedCurrentValueSummary,
            CleanAttachment_ExtendedCurrentValueSummary,
            DirtyAttachment_ExtendedCurrentValueSummary,
            PendingAttachment_ExtendedCurrentValueSummary,
            CurrentGoogleAttachmentValue_ExtendedCurrentValueSummary,
            CurrentSharepointAttachmentValue_ExtendedCurrentValueSummary,
            Active_ExtendedCurrentValueSummary,
            Automated_ExtendedCurrentValueSummary,
            Disabled_ExtendedCurrentValueSummary,
            External_ExtendedCurrentValueSummary,
            Locked_ExtendedCurrentValueSummary,
            Service_ExtendedCurrentValueSummary,
            CurrentNumericRangeValue_ExtendedCurrentValueSummary,
            CurrentJobValue_ExtendedCurrentValueSummary
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        valueType:
          type: string
        discriminator:
          type: string
        textValue:
          type: string
        numericValue:
          type: number
          format: double
        isDefault:
          type: boolean
        archived:
          type: boolean
        priority:
          type: integer
          format: int32
        field:
          type: string
          description: field
        userGroup:
          type: string
          description: usergroup
        fieldId:
          type: string
        idOrTransientId:
          type: string
        transientIdOrId:
          type: string
        textOrNumericValue:
          type: string
        empty:
          type: boolean
      required:
        - active
        - archived
        - created
        - discriminator
        - field
        - id
        - isDefault
        - numericValue
        - priority
        - textValue
        - updated
        - userGroup
        - valueType
  securitySchemes:
    ApiToken:
      type: http
      scheme: bearer
      bearerFormat: API Token
    basic:
      type: http
      scheme: basic

````

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