---
title: "Outline artifacts"
method: GET
path: "/api/v1/alpha/artifacts/outline"
tags: ["alpha"]
---

# Outline artifacts

`GET /api/v1/alpha/artifacts/outline`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/alpha/artifacts/outline`
- Auth: OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Get what one saved version of a PowerPoint, Word or Excel file Alpha made holds, as the file Sandbox read it from its bytes: slides with their shape ids, names, placeholders, text and notes; paragraphs with their styles and runs; sheets with their used ranges and charts. The units alpha_artifacts_edit addresses. Null for a version saved before outlines were recorded.

## Query parameters

- `id` string, required: The ID of any version of a file Alpha made

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- AlphaArtifactsOutlineResponse
  - `structure` union, required: What this version holds; null when it was saved before outlines were recorded
    - object
      - `format` 'pptx', required
      - `layouts` string[], required
      - `slides` object[], required
        - `number` integer, required
        - `layout` string
        - `shapes` object[], required
          - `id` integer, required
          - `name` string, required
          - `kind` 'text' | 'shape' | 'picture' | 'chart' | 'table' | 'diagram' | 'object' | 'group' | 'connector', required
          - `placeholder` string
          - `paragraphs` string[]
          - `clipped` true
          - `altText` string
        - `notes` string
        - `notesClipped` true
    - object
      - `format` 'docx', required
      - `styles` object[], required
        - `id` string, required
        - `name` string, required
      - `truncated` boolean, required
      - `paragraphs` object[], required
        - `number` integer, required
        - `style` string
        - `text` string, required
        - `runs` string[]
        - `clipped` true
        - `bookmarks` string[]
    - object
      - `format` 'xlsx', required
      - `sheets` object[], required
        - `name` string, required
        - `dimension` string
        - `charts` object[], required
          - `type` string, required
          - `title` string

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

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