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

# List scenes

> Retrieve all scenes belonging to the authenticated user, ordered by creation date (newest first).



## OpenAPI

````yaml /openapi.json get /v1/scenes
openapi: 3.1.0
info:
  title: Gizmo API
  version: 1.0.0
  description: >-
    Programmatic API for AI-powered 3D simulation authoring.


    Generate physics-ready 3D scenes and articulated assets from natural
    language prompts. Export to USD / USDZ (Isaac Sim), MJCF (MuJoCo), and SDF
    (Gazebo). GLB is only available via the editor UI.
servers:
  - url: https://api.gizmo.antimlabs.com
    description: Production
security: []
tags:
  - name: Scenes
    description: >-
      Create, retrieve, update, and delete 3D simulation scenes. Generation is
      async — `POST /v1/scenes` returns a `job_id` for polling.
  - name: Assets
    description: >-
      Manage individual 3D assets (articulated objects, furniture, equipment).
      Each asset belongs to a scene and contains geometry, joints, materials,
      and physics data.
  - name: Jobs
    description: >-
      Monitor and control async generation jobs. Poll with `GET /v1/jobs/{id}`,
      stream real-time progress via `GET /v1/jobs/{id}/events` (SSE), or cancel
      with `POST /v1/jobs/{id}/cancel`.
  - name: Catalog
    description: >-
      Browse the premade asset library — thousands of physics-ready 3D objects
      organized by category. Download GLB/USDZ directly.
  - name: Account
    description: View your identity and API usage statistics.
paths:
  /v1/scenes:
    get:
      tags:
        - Scenes
      summary: List scenes
      description: >-
        Retrieve all scenes belonging to the authenticated user, ordered by
        creation date (newest first).
      operationId: list_scenes_v1_scenes_get
      parameters:
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
        - name: x-gizmo-service-token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Gizmo-Service-Token
        - name: x-gizmo-user-id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Gizmo-User-Id
        - name: x-gizmo-convex-user-id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Gizmo-Convex-User-Id
      responses:
        '200':
          description: List of scene summaries
          content:
            application/json:
              schema: {}
              example:
                ok: true
                scenes:
                  - id: jh72k3m4n5p6q7r8
                    name: Robot Kitchen
                    pipeline_status: completed
                    pipeline_prompt: A modern kitchen
                    created_at: 1717800000000
                    updated_at: 1717800060000
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
components:
  schemas:
    ApiErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ApiErrorDetail'
      type: object
      required:
        - error
      title: ApiErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ApiErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - scene_not_found
        message:
          type: string
          title: Message
          description: Human-readable description
          examples:
            - Scene sc_abc123 not found
        status:
          type: integer
          title: Status
          description: HTTP status code
          examples:
            - 404
      type: object
      required:
        - code
        - message
        - status
      title: ApiErrorDetail
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````