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

# Export a world

> Export a generated world asset.

PLY splat exports are converted synchronously, cached in GCS, and returned
as completed operations. HQ mesh exports reuse the existing async mesh
export service and return an in-progress operation.



## OpenAPI

````yaml POST /marble/v1/worlds/{world_id}:export
openapi: 3.1.0
info:
  description: Public-facing API for the Marble platform
  summary: Marble Public API v1
  title: Marble Public API v1
  version: 1.0.0
servers:
  - description: World API
    url: https://api.worldlabs.ai
security:
  - ApiKeyAuth: []
paths:
  /marble/v1/worlds/{world_id}:export:
    post:
      summary: Export World
      description: >-
        Export a generated world asset.


        PLY splat exports are converted synchronously, cached in GCS, and
        returned

        as completed operations. HQ mesh exports reuse the existing async mesh

        export service and return an in-progress operation.
      operationId: export_world_marble_v1_worlds__world_id__export_post
      parameters:
        - in: path
          name: world_id
          required: true
          schema:
            title: World Id
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportWorldRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExportWorldResponse'
          description: Successful Response
        '402':
          content:
            application/json:
              example:
                detail: >-
                  Insufficient API credits to start this request. Add credits or
                  enable auto-refill at https://platform.worldlabs.ai/billing.
          description: The account has insufficient API credits for this request.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ExportWorldRequest:
      description: Request to export a generated world asset.
      properties:
        asset_type:
          description: 'Asset family to export: ''splats'' or ''mesh''.'
          enum:
            - splats
            - mesh
          title: Asset Type
          type: string
        format:
          description: Requested export format.
          enum:
            - ply
            - glb
          title: Format
          type: string
        mesh_variant:
          default: textured
          description: Mesh variant to return when an HQ mesh already exists.
          enum:
            - textured
            - vertex_colored
          title: Mesh Variant
          type: string
        resolution:
          default: full_res
          description: Splat resolution to convert when exporting splats as PLY.
          enum:
            - full_res
            - 500k
            - 150k
            - 100k
          title: Resolution
          type: string
      required:
        - asset_type
        - format
      title: ExportWorldRequest
      type: object
    ExportWorldResponse:
      description: Response from world export endpoint.
      properties:
        cost:
          anyOf:
            - $ref: '#/components/schemas/OperationCost'
            - type: 'null'
          description: >-
            Settled credit cost for the operation. Populated only on successful
            completion.
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Creation timestamp
          title: Created At
        done:
          description: True if the operation is completed
          title: Done
          type: boolean
        error:
          anyOf:
            - $ref: '#/components/schemas/OperationError'
            - type: 'null'
          description: Error information if the operation failed
        expires_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Expiration timestamp
          title: Expires At
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Service-specific metadata, such as progress percentage
          title: Metadata
        operation_id:
          description: Operation identifier
          title: Operation Id
          type: string
        response:
          anyOf:
            - $ref: '#/components/schemas/ExportWorldResult'
            - type: 'null'
          description: >-
            Result payload when done=true and no error. Structure depends on
            operation type.
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: Last update timestamp
          title: Updated At
      required:
        - operation_id
        - done
      title: ExportWorldResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    OperationCost:
      description: Settled credit cost for a successful operation.
      properties:
        line_items:
          description: Usage events that make up the operation's total credits
          items:
            $ref: '#/components/schemas/OperationCostLineItem'
          title: Line Items
          type: array
        total_credits:
          description: Total credits charged for the operation
          title: Total Credits
          type: integer
      required:
        - total_credits
      title: OperationCost
      type: object
    OperationError:
      description: Error information for a failed operation.
      properties:
        code:
          anyOf:
            - type: integer
            - type: 'null'
          description: Error code
          title: Code
        message:
          anyOf:
            - type: string
            - type: 'null'
          description: Error message
          title: Message
      title: OperationError
      type: object
    ExportWorldResult:
      description: Downloadable exported world asset.
      properties:
        asset_type:
          description: Exported asset family
          enum:
            - splats
            - mesh
          title: Asset Type
          type: string
        format:
          description: Exported file format
          enum:
            - ply
            - glb
          title: Format
          type: string
        mesh_variant:
          anyOf:
            - enum:
                - textured
                - vertex_colored
              type: string
            - type: 'null'
          description: Mesh variant returned for this export, if applicable
          title: Mesh Variant
        resolution:
          anyOf:
            - type: string
            - type: 'null'
          description: Splat resolution used for this export, if applicable
          title: Resolution
        url:
          description: Download URL for the exported asset
          title: Url
          type: string
      required:
        - asset_type
        - format
        - url
      title: ExportWorldResult
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    OperationCostLineItem:
      description: A single usage event contributing to an operation's total credits.
      properties:
        credits:
          description: Credits charged for this usage event
          title: Credits
          type: integer
        name:
          description: Human-readable usage event name
          title: Name
          type: string
      required:
        - name
        - credits
      title: OperationCostLineItem
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: API key for authentication. Get your key from the developer portal.
      in: header
      name: WLT-Api-Key
      type: apiKey

````