---
title: "List the caller's shape libraries, newest first."
method: GET
path: "/shape-libraries"
tags: ["Shape libraries"]
---

# List the caller's shape libraries, newest first.

`GET /shape-libraries`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/shape-libraries`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Response `200`

Success.

- object
  - `libraries` ShapeLibrary[], required
    - `createdAt` number, required
    - `id` string, required
    - `items` ShapeLibraryItem[], required
      - `elements` Element[], required
        - union
          - union
            - ShapeElement
              - …
            - TextElement
              - …
            - StickyElement
              - …
            - ImageElement
              - …
            - FreehandElement
              - …
            - PathElement
              - …
            - TableElement
              - …
            - AnnotationElement
              - …
            - LinkCardElement
              - …
            - VideoElement
              - …
          - ArrowElement
            - `arrowEnds` 'from' | 'to' | 'both' | 'none'
            - `arrowStyle` 'straight' | 'curved' | 'angled'
            - `arrowheadColor` string
            - `arrowheadShape` 'triangle' | 'triangle-hollow' | 'line' | 'circle' | 'circle-hollow' | 'diamond' | 'diamond-hollow' | 'one' | 'zero-or-one' | 'many' | 'zero-or-many' | 'one-or-many'
            - `arrowheadSize` 'small' | 'medium' | 'large' | 'extra-large'
            - `arrowheadStartShape` 'triangle' | 'triangle-hollow' | 'line' | 'circle' | 'circle-hollow' | 'diamond' | 'diamond-hollow' | 'one' | 'zero-or-one' | 'many' | 'zero-or-many' | 'one-or-many'
            - `curveOffset` object
              - …
            - `curvePoints` object[]
              - …
            - `elbowOffset` object
              - …
            - `exactEnd` boolean
            - `exactStart` boolean
            - `finish` 'flexible' | 'professional' | 'sketch' | 'marker'
            - `flow` 'dashes' | 'dots' | 'beads' | 'pulse' | 'grow' | 'glow' | 'heartbeat' | 'breathe' | 'shimmer' | 'signal' | 'draw' | 'comet' | 'rainbow' | 'strobe' | 'wind'
            - `flowRepeat` boolean
            - `flowSpeed` 'slowest' | 'slow' | 'normal' | 'fast'
            - `font` string
            - `from` union, required
              - …
            - `id` string, required
            - `label` string
            - `labelFill` string
            - `labelMaxWidth` number
            - `labelOffset` object
              - …
            - `layerId` string
            - `link` union
              - …
            - `locked` boolean
            - `opacity` number
            - `penColour` union
              - …
            - `penTextColour` union
              - …
            - `routeBehind` boolean
            - `strokeColor` string
            - `strokeStyle` 'solid' | 'dashed' | 'dotted' | 'dash-dot' | 'long-dash' | 'dash-dot-dot'
            - `strokeSwatch` 1 | 2 | 3 | 4 | 5 | 6
            - `strokeWidth` number
            - `textBold` boolean
            - `textColor` string
            - `textItalic` boolean
            - `textSize` union
              - …
            - `textStrikethrough` boolean
            - `textUnderline` boolean
            - `to` union, required
              - …
            - `type` 'arrow', required
      - `height` number, required
      - `id` string, required
      - `title` string, required
      - `width` number, required
    - `name` string, required
    - `ownerId` string, required
    - `source` 'drawio', required: Where a library came from; one value today.
    - `updatedAt` number, required

## Other responses

- `401`: Error.
- `429`: Rate limited. Back off and retry.

---

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