---
title: "Preview Panel Geometry"
method: POST
path: "/v1/geometry/panels/visualization"
tags: ["geometry"]
---

# Preview Panel Geometry

`POST /v1/geometry/panels/visualization`

## Request

- Base URL: `https://api.shapemaker.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.shapemaker.io/v1/geometry/panels/visualization`
- Auth: OAuth 2
  - Password
  - Token URL: `/v1/auth`

## Request body

- PanelVisualizationInput
  - `geometry` CustomPanelGeometryInput[], required
    - `lines` CustomPanelGeometryLineInput[], required
      - `p1` Point2D, required
        - `x` number, required
        - `y` number, required
      - `p2` Point2D, required
        - `x` number, required
        - `y` number, required
      - `metadata` CustomPanelGeometryLineMetadataInput, required
        - `memberType` 'Leg1' | 'Diagonal1' | 'Diagonal2' | 'Horizontal1' | 'Horizontal2' | 'Secondary1' | 'Secondary2' | 'Secondary3' | 'Secondary4' | 'Hip1' | 'Hip2' | 'Hip3' | 'Hip4' | 'Plan1' | 'Plan2' | 'Plan3' | 'Plan4' | 'GuyWire' | 'MonopoleLeg' | 'RigidArm' | 'SingleLeg' | 'RooftopBeam' | 'MountMember', required
    - `bucklingSupports` CustomGeometryBucklingSupportInput[], required
      - `p` Point2D, required
        - `x` number, required
        - `y` number, required
      - `inPlane` boolean, required
      - `outOfPlane` boolean, required
  - `numberOfLegs` 3 | 4, required
  - `hipBracingGeometry` HipBracingGeometryInput
    - `panelType` 'K' | 'M' | 'X', required
    - `framePoints` Point2D[], required
      - `x` number, required
      - `y` number, required
    - `lines` CustomPanelGeometryLineInput[], required
      - `p1` Point3D, required
        - `x` number, required
        - `y` number, required
        - `z` number, required
      - `p2` Point3D, required
        - `x` number, required
        - `y` number, required
        - `z` number, required
      - `metadata` CustomPanelGeometryLineMetadata, required
        - `member_type` 'Leg1' | 'Diagonal1' | 'Diagonal2' | 'Horizontal1' | 'Horizontal2' | 'Secondary1' | 'Secondary2' | 'Secondary3' | 'Secondary4' | 'Hip1' | 'Hip2' | 'Hip3' | 'Hip4' | 'Plan1' | 'Plan2' | 'Plan3' | 'Plan4' | 'GuyWire' | 'MonopoleLeg' | 'RigidArm' | 'SingleLeg' | 'RooftopBeam' | 'MountMember', required

## Response `200`

Successful Response

- PanelVisualizationView
  - `members` RenderableMember[], required
    - `shapes` RenderableShape3D[], required
      - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
      - `geometry` union, required
        - BoxDimension
          - `height` number, required
          - `width` number, required
          - `depth` number, required
        - CylinderDimension
          - `length` number, required
          - `diameter` number, required
        - PolylineDimension
          - `points` Point[], required
            - `x` number, required
            - `y` number, required
            - `z` number, required
            - `point_number` integer
          - `is_closed` boolean, required
        - TaperedCylinderDimension
          - `length` number, required
          - `diameter_bottom` number, required
          - `diameter_top` number, required
          - `sides` integer, required
        - NoDimension
      - `matrix` number[], required
      - `material` Material, required
        - `color` string, required
        - `opacity` number
        - `roughness` number
        - `metalness` number
    - `member_type` 'Leg1' | 'Diagonal1' | 'Diagonal2' | 'Horizontal1' | 'Horizontal2' | 'Secondary1' | 'Secondary2' | 'Secondary3' | 'Secondary4' | 'Hip1' | 'Hip2' | 'Hip3' | 'Hip4' | 'Plan1' | 'Plan2' | 'Plan3' | 'Plan4' | 'GuyWire' | 'MonopoleLeg' | 'RigidArm' | 'SingleLeg' | 'RooftopBeam' | 'MountMember', required
    - `panel_index` integer, nullable
    - `section_name` string, nullable
    - `steel_grade` string, nullable
    - `orientation_deg` number, nullable
    - `bottom_elevation_m` number, nullable
    - `top_elevation_m` number, nullable
    - `length_m` number, nullable
  - `bucklingSupports` RenderableShape3D[], required
    - `type` 'box' | 'pipe' | 'prism' | 'cylinder' | 'tapered_cylinder', required
    - `geometry` union, required
      - BoxDimension
        - `height` number, required
        - `width` number, required
        - `depth` number, required
      - CylinderDimension
        - `length` number, required
        - `diameter` number, required
      - PolylineDimension
        - `points` Point[], required
          - `x` number, required
          - `y` number, required
          - `z` number, required
          - `point_number` integer
        - `is_closed` boolean, required
      - TaperedCylinderDimension
        - `length` number, required
        - `diameter_bottom` number, required
        - `diameter_top` number, required
        - `sides` integer, required
      - NoDimension
    - `matrix` number[], required
    - `material` Material, required
      - `color` string, required
      - `opacity` number
      - `roughness` number
      - `metalness` number

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/shapemaker/apis/shapemaker-api.md) - [All operations](https://skmtc.dev/shapemaker/apis/shapemaker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shapemaker/apis/shapemaker-api/revisions/b8461cf1236c?raw)