> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paperjoy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Historia zmian

> Zmiany w API Paperjoy, integracjach i tej dokumentacji.

## 2026-10-19

* **Szkice pocztówek.** Wyślij `"draft": true` do `POST /api/postcards`, aby zapisać darmowy szkic. Edytuj go przez `PATCH /api/postcards/{id}`, zamów przez `POST /api/postcards/{id}/submit` albo usuń przez `DELETE /api/postcards/{id}`. Kredyt jest pobierany przy wysyłce. Pocztówki mają nowe pole `submitted_at`, a `GET /api/postcards` przyjmuje `status`. Możesz mieć do 100 otwartych szkiców, a szkice niezmieniane przez 30 dni są usuwane. Bez `draft` nic się nie zmienia. Zobacz [Szkice](https://docs.paperjoy.co/postcards/drafts.md).
* **Serwer MCP 1.2.0.** `create-postcard-tool` domyślnie zapisuje szkic. Nowe narzędzia: `update-draft-tool`, `preview-postcard-tool`, `submit-postcard-tool` i `delete-draft-tool`. Wysyłanie wymaga nowego uprawnienia `mcp:submit`; połącz serwer ponownie, aby je przyznać. Zobacz [Serwer MCP](https://docs.paperjoy.co/integrations/mcp.md).
* **Jeden status realizacji.** Robot pisze kopertę i kartkę w jednym przebiegu, więc statusy `envelope_in_progress`, `envelope_completed` i `card_in_progress` zastępuje jeden status `in_progress`. Pocztówki, które miały jeden z tych statusów, mają teraz status `in_progress`. Nieznane statusy traktuj jako „w realizacji”. Zobacz [Statusy pocztówek](https://docs.paperjoy.co/postcards/statuses.md).

## 2026-10-18

* **Stronicowana lista pocztówek.** `GET /api/postcards` zwraca 50 pocztówek na stronie, od najnowszych. Użyj `page` i `per_page` (maksymalnie 100) i przechodź po `links.next`. Zobacz [Śledzenie pocztówek](https://docs.paperjoy.co/postcards/list-and-retrieve.md).
* **Bezpieczne ponowienia w MCP.** `create-postcard-tool` przyjmuje opcjonalny `idempotency_key`, więc ponowione wywołanie nie tworzy drugiej pocztówki.

## 2026-10-17

Pierwsza publiczna wersja dokumentacji Paperjoy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.