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

# Remove From Version Stack

> Remove an asset from its version stack.

The asset becomes standalone (version fields set to NULL). If only one
asset remains in the stack, the stack is dissolved and that asset also
becomes standalone.

Returns 409 with conflict details if the removed asset's name conflicts
with an existing item in its parent directory and no conflict_resolutions
are provided.



## OpenAPI

````yaml /api-reference/openapi.json post /assets/versions/remove
openapi: 3.1.0
info:
  title: Aspect Platform API
  description: A FastAPI application for Aspect Platform functionality
  version: 0.0.0
servers:
  - url: https://api.aspect.inc
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /assets/versions/remove:
    post:
      tags:
        - Assets
      summary: Remove From Version Stack
      description: >-
        Remove an asset from its version stack.


        The asset becomes standalone (version fields set to NULL). If only one

        asset remains in the stack, the stack is dissolved and that asset also

        becomes standalone.


        Returns 409 with conflict details if the removed asset's name conflicts

        with an existing item in its parent directory and no
        conflict_resolutions

        are provided.
      operationId: post_Assets_assets_versions_remove
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveFromVersionStackRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveFromVersionStackResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RemoveFromVersionStackRequest:
      properties:
        asset_id:
          type: string
          format: uuid
          title: Asset Id
          description: ID of the asset to remove from its version stack
        conflict_resolutions:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/ItemConflictResolution'
              type: object
            - type: 'null'
          title: Conflict Resolutions
          description: >-
            Resolution strategies for name conflicts when the removed asset
            becomes standalone. Keys are string UUIDs of conflicting items. If
            not provided and conflicts exist, returns 409.
      type: object
      required:
        - asset_id
      title: RemoveFromVersionStackRequest
      description: API request to remove an asset from its version stack
    RemoveFromVersionStackResponse:
      properties:
        stack_dissolved:
          type: boolean
          title: Stack Dissolved
          description: TRUE if the stack collapsed to a single asset and was dissolved
      type: object
      required:
        - stack_dissolved
      title: RemoveFromVersionStackResponse
      description: API response for removing an asset from its version stack
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ItemConflictResolution:
      properties:
        resolution:
          $ref: '#/components/schemas/ConflictResolution'
          description: 'How to resolve this conflict: keep_both, replace, or skip'
        auto_rename_style:
          anyOf:
            - $ref: '#/components/schemas/AutoRenameStyle'
            - type: 'null'
          description: >-
            Rename style when resolution is keep_both. Defaults to parenthesized
            for assets and numeric for directories if not provided.
      type: object
      required:
        - resolution
      title: ItemConflictResolution
      description: >-
        Per-item conflict resolution with optional auto-rename style for
        KEEP_BOTH
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ConflictResolution:
      type: string
      enum:
        - keep_both
        - replace
        - skip
      title: ConflictResolution
      description: Resolution strategy for a single name conflict during move operations
    AutoRenameStyle:
      type: string
      enum:
        - parenthesized
        - numeric
      title: AutoRenameStyle
      description: Style for auto-renaming items when name conflicts occur during creation
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT in Authorization header. 'Bearer ' prefix optional.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Aspect API key (sk_...) in Authorization header. 'Bearer ' optional.

````