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

# Delete a world

> Delete a world by ID.

Permanently deletes a world and its associated assets.
Only the world owner can delete a world.

Args:
    world_id: The unique identifier of the world to delete.

Returns:
    DeleteWorldResponse confirming the deletion.

Raises:
    HTTPException: 403 if user is not the world owner
    HTTPException: 404 if world not found
    HTTPException: 500 if deletion fails



## OpenAPI

````yaml DELETE /marble/v1/worlds/{world_id}
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}:
    delete:
      summary: Delete World
      description: |-
        Delete a world by ID.

        Permanently deletes a world and its associated assets.
        Only the world owner can delete a world.

        Args:
            world_id: The unique identifier of the world to delete.

        Returns:
            DeleteWorldResponse confirming the deletion.

        Raises:
            HTTPException: 403 if user is not the world owner
            HTTPException: 404 if world not found
            HTTPException: 500 if deletion fails
      operationId: delete_world_marble_v1_worlds__world_id__delete
      parameters:
        - in: path
          name: world_id
          required: true
          schema:
            title: World Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteWorldResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    DeleteWorldResponse:
      description: Response from world deletion endpoint.
      properties:
        deleted:
          description: Whether the world was successfully deleted
          title: Deleted
          type: boolean
        world_id:
          description: ID of the deleted world
          title: World Id
          type: string
      required:
        - world_id
        - deleted
      title: DeleteWorldResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      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
  securitySchemes:
    ApiKeyAuth:
      description: API key for authentication. Get your key from the developer portal.
      in: header
      name: WLT-Api-Key
      type: apiKey

````