---
search:
  tags:
    - Operations
    - POST
seo:
  description: >-
    Saves an arXiv link's paper as its own document card. Saving the same link
    again… Reference for the POST /v1/cards/{cardId}/save-pdf endpoint in the
    Teak API.
sidebar:
  label: Save a paper's PDF
  badge: POST
title: Save a paper's PDF
type: openapi-operation
---
Saves an arXiv link's paper as its own document card. Saving the same link again returns that card; a save still running answers 409 IN_PROGRESS. Counts as a new card toward the plan's limit.

`POST /v1/cards/{cardId}/save-pdf`

**Responses**

- `200` — The document an earlier save made from this link, with \`created: false\`
- `201` — A new document card holding the paper's PDF
- `400` — INVALID\_INPUT: the card is not an arXiv link with a PDF (a withdrawn paper has none). CARD\_LIMIT\_REACHED: the free plan's card limit
- `404` — Card not found
- `409` — CONFLICT: the card is in Trash. IN\_PROGRESS: a save of this PDF is still running; try again in a moment
- `413` — FILE\_TOO\_LARGE: the PDF is over 100 MB
- `415` — UNSUPPORTED\_TYPE: arXiv didn't answer with a PDF
- `429` — RATE\_LIMITED: 30 new cards a minute, as for creating cards
- `503` — SERVICE\_UNAVAILABLE: arXiv couldn't be reached

Response example, 200:

```json
{
  "cardId": "string",
  "created": true
}
```