---
title: "Render one sheet of a draft as a PNG"
method: POST
path: "/api/v0/desk/drafts/render"
tags: ["Desk"]
---

# Render one sheet of a draft as a PNG

`POST /api/v0/desk/drafts/render`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/desk/drafts/render`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/desk/drafts/render/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- DraftRenderRequest
  - `files` object, required: The draft's files, {path: text}, paths relative to the project root.
  - `path` string, required: The model file among ``files``.
  - `document` string, required
  - `sheet` integer
  - `view` union: A 3D assembly's view: a named view (iso, front, back, left, right, top, bottom) or [azimuth, elevation] in degrees, azimuth 0 from the front and 90 from the right; iso when absent.
    - string
    - number[]
  - `parts` string[]: A 3D assembly's parts to draw, as tag patterns (``FAN-*``); every part when empty.
  - `hide` string[]: A 3D assembly's parts to leave out, as tag patterns (``FIN-*``, ``*-S?``).

## Response `200`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/desk/drafts/render/post.md)

---

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