---
title: "Zotero Import"
method: POST
path: "/api/zotero/import"
---

# Zotero Import

`POST /api/zotero/import`

## Request

- Base URL: `https://api.openpaper.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openpaper.ai/api/zotero/import`
- Auth: API key in header `Authorization`

Import selected journal articles, conference papers, and preprints from Zotero (PDF or URL fallback).

## Request body

- ZoteroImportRequest
  - `item_keys` string[], required

## Response `200`

Successful Response

- ZoteroImportResponse
  - `imported` ZoteroImportItemResult[], required
    - `zotero_item_key` string, required
    - `paper_id` string, nullable
    - `upload_job_id` string, nullable
    - `import_source` string, nullable
    - `title` string, nullable
  - `imported_count` integer, required
  - `imported_via_url` integer, required
  - `skipped_already_imported` integer, required
  - `errors` ZoteroImportError[], required
    - `zotero_item_key` string, required
    - `error` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openpaper/apis/open-paper.md) - [All operations](https://skmtc.dev/openpaper/apis/open-paper/llms.txt) - [OpenAPI document](https://skmtc.dev/openpaper/apis/open-paper/revisions/c2ad03216101?raw)