---
title: "Get Deck Outline External"
method: GET
path: "/decks/{deck_id}/outline"
tags: ["decks"]
---

# Get Deck Outline External

`GET /decks/{deck_id}/outline`

## Request

- Base URL: `https://api.presentations.ai/api/v1`
- URL: `https://api.presentations.ai/api/v1/decks/{deck_id}/outline`
- Auth: HTTP bearer

Durable outline state for a generated deck.

## Path parameters

- `deck_id` string, uuid, required

## Response `200`

Successful Response

- DeckOutline: Durable outline state for a generated deck.
  - `deck_id` string, uuid, required
  - `deck_session_id` string, uuid, required
  - `status` 'DRAFT' | 'OUTLINE_FINALIZED', required: Deck-generation lifecycle state.
  - `outline` PresentationOutline: Complete validated presentation outline.
    - `documentTitle` string, nullable
    - `hook` string, nullable
    - `researchSummary` string, nullable
    - `contentLanguage` string, nullable
    - `footerText` string, nullable
    - `imagePrompt` string, nullable
    - `contentMode` string, nullable
    - `companyName` string, nullable
    - `companyDomain` string, nullable
    - `slides` PresentationOutlineSlide[], required
      - `heading` string, required
      - `subheading` string, nullable
      - `description` string, nullable
      - `category` string, nullable
      - `useCase` string, nullable
      - `speakerNotes` string, nullable
      - `visualComposition` string[], nullable
      - `graphicSubtypes` object, nullable
      - `graphics` OutlineGraphic[], nullable
        - `type` string, required
        - `heading` string, nullable
        - `items` OutlineGraphicItem[], nullable
          - `h` string, nullable
          - `b` string, nullable
          - `v` string, nullable
          - `s` string, nullable
          - `i` string, nullable
          - `sub` string[], nullable
          - `tags` string[], nullable
          - `metric` string, nullable
          - `entity` string, nullable
          - `entityDomain` string, nullable
          - `trend` string, nullable
          - `status` string, nullable
          - `delta` string, nullable
          - `period` string, nullable
        - `rows` string[], nullable
        - `extra` OutlineGraphicItem[], nullable
          - `h` string, nullable
          - `b` string, nullable
          - `v` string, nullable
          - `s` string, nullable
          - `i` string, nullable
          - `sub` string[], nullable
          - `tags` string[], nullable
          - `metric` string, nullable
          - `entity` string, nullable
          - `entityDomain` string, nullable
          - `trend` string, nullable
          - `status` string, nullable
          - `delta` string, nullable
          - `period` string, nullable
        - `callout` string, nullable
        - `stamp` string, nullable
        - `footnote` string, nullable
        - `ref` OutlineRef: A benchmark/target line a chart should show (`<ref label v/>`).
          - `label` string, nullable
          - `v` string, nullable
        - `highlight` OutlineHighlight: The one element of a graphic the heading rests on (`<highlight kind at>why</highlight>`).
          - `kind` string, nullable
          - `at` string, nullable
          - `text` string, nullable
      - `imageQuery` string, nullable
      - `sources` OutlineSource[], nullable
        - `domain` string, nullable
        - `text` string, nullable
        - `url` string, nullable
      - `confidence` string, nullable
  - `final_outline` PresentationOutline: Complete validated presentation outline.
    - `documentTitle` string, nullable
    - `hook` string, nullable
    - `researchSummary` string, nullable
    - `contentLanguage` string, nullable
    - `footerText` string, nullable
    - `imagePrompt` string, nullable
    - `contentMode` string, nullable
    - `companyName` string, nullable
    - `companyDomain` string, nullable
    - `slides` PresentationOutlineSlide[], required
      - `heading` string, required
      - `subheading` string, nullable
      - `description` string, nullable
      - `category` string, nullable
      - `useCase` string, nullable
      - `speakerNotes` string, nullable
      - `visualComposition` string[], nullable
      - `graphicSubtypes` object, nullable
      - `graphics` OutlineGraphic[], nullable
        - `type` string, required
        - `heading` string, nullable
        - `items` OutlineGraphicItem[], nullable
          - `h` string, nullable
          - `b` string, nullable
          - `v` string, nullable
          - `s` string, nullable
          - `i` string, nullable
          - `sub` string[], nullable
          - `tags` string[], nullable
          - `metric` string, nullable
          - `entity` string, nullable
          - `entityDomain` string, nullable
          - `trend` string, nullable
          - `status` string, nullable
          - `delta` string, nullable
          - `period` string, nullable
        - `rows` string[], nullable
        - `extra` OutlineGraphicItem[], nullable
          - `h` string, nullable
          - `b` string, nullable
          - `v` string, nullable
          - `s` string, nullable
          - `i` string, nullable
          - `sub` string[], nullable
          - `tags` string[], nullable
          - `metric` string, nullable
          - `entity` string, nullable
          - `entityDomain` string, nullable
          - `trend` string, nullable
          - `status` string, nullable
          - `delta` string, nullable
          - `period` string, nullable
        - `callout` string, nullable
        - `stamp` string, nullable
        - `footnote` string, nullable
        - `ref` OutlineRef: A benchmark/target line a chart should show (`<ref label v/>`).
          - `label` string, nullable
          - `v` string, nullable
        - `highlight` OutlineHighlight: The one element of a graphic the heading rests on (`<highlight kind at>why</highlight>`).
          - `kind` string, nullable
          - `at` string, nullable
          - `text` string, nullable
      - `imageQuery` string, nullable
      - `sources` OutlineSource[], nullable
        - `domain` string, nullable
        - `text` string, nullable
        - `url` string, nullable
      - `confidence` string, nullable

## Other responses

- `401`: Missing, malformed, expired, or revoked Bearer API key.
- `403`: The API key, workspace role, project scope, or plan lacks permission.
- `404`: The resource does not exist or is outside the caller's scope.
- `422`: A path, query, header, or request-body field failed validation.
- `429`: The caller exceeded the API rate limit.
- `500`: Unexpected server failure. Retry only idempotent operations and retain trace_id.

---

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