---
title: "Create Content Library Item from File Upload"
method: POST
path: "/public/v1/content-library-items?upload"
tags: ["Content Library Items"]
---

# Create Content Library Item from File Upload

`POST /public/v1/content-library-items?upload`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/content-library-items?upload`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/content-library-items%3Fupload/post.ts> (a function with typed inputs; its response is checked against the schema)

This asynchronous endpoint allows users to create a new CLI by uploading a file.
The uploaded file is processed in the background to generate the CLI.
The maximum allowable file size for upload is 100 MB.
Field tags and form fields are not supported yet.
Once the file is uploaded, the processing will happen asynchronously, and users need to check the status of the CLI creation.

## Request body `multipart/form-data`

- object
  - `file` string, binary: Binary PDF File
  - `data` object: JSON as a multipart/form-data request.
    - `editable` boolean: Only applicable when creating a content library item from a DOCX file. When `true`, the DOCX is converted into editable content, so the resulting content library item can be edited.
    - `name` string: The name of the Content Library Item.

## Response `201`

OK

- ContentLibraryResponse
  - `id` string
  - `name` string
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `version` string
  - `status` 'cli.UPLOADED' | 'cli.PROCESSED' | 'cli.ERROR'

## Other responses

- `400`: Bad Request
- `401`: Authentication error
- `403`: Permission error
- `429`: Too Many Requests

## Changes

- **2026-11-03** `b9a306b1a421`: 1 info
  - added the new optional request property `data/allOf[#/components/schemas/ContentLibraryItemCreateRequest]/editable`

[Operation history](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/changes/public/v1/content-library-items%3Fupload/post.md)

---

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