Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane.
Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Paperjoy","description":"Dokumentacja Paperjoy: wysyłaj ręcznie pisane pocztówki z edytora, przez Zapier, MCP lub API.","colors":{"primary":"#171717","light":"#FAFAFA","dark":"#171717"},"logo":{"light":"https://mintcdn.com/paperjoy/uLGEyGsDEbQfn2is/logo/light.svg?fit=max\u0026auto=format\u0026n=uLGEyGsDEbQfn2is\u0026q=85\u0026s=f421bce949674ab0c88ab69890f71993","dark":"https://mintcdn.com/paperjoy/uLGEyGsDEbQfn2is/logo/dark.svg?fit=max\u0026auto=format\u0026n=uLGEyGsDEbQfn2is\u0026q=85\u0026s=aa2e2aef22a909e258ab7df213a055bf","href":"https://paperjoy.co"},"favicon":"https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/logo/mark.svg?fit=max\u0026auto=format\u0026n=F1MJj4Vyrx0MCZIR\u0026q=85\u0026s=1a3fe3abd6a211223f8aae3a2ffdfc6a","appearance":{"default":"light","strict":true},"navbar":{"links":[],"primary":{"type":"button","label":"Open Paperjoy","href":"https://paperjoy.co"}},"footer":{"socials":{}},"seo":{"metatags":{"og:site_name":"Paperjoy Docs","twitter:card":"summary_large_image"},"organization":{"id":"https://paperjoy.co/#organization","name":"Paperjoy","legalName":"Paperjoy Norbert Jurga","url":"https://paperjoy.co/","logo":"https://paperjoy.co/icon-512.png"},"indexing":"navigable"},"fonts":{"family":"Instrument Sans"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintcdn.com/paperjoy/dzsHsibbZz8x9Ehv/images/og/background.png?fit=max\u0026auto=format\u0026n=dzsHsibbZz8x9Ehv\u0026q=85\u0026s=0b4fdde338ccfafbc781dd527894cd99"},"navigation":{"global":{"anchors":[{"anchor":"Paperjoy","icon":"house","href":"/"},{"anchor":"API","icon":"square-terminal","href":"/reference/introduction"},{"anchor":"Changelog","icon":"scroll-text","href":"/changelog"}]},"directory":"card","languages":[{"language":"pl","default":true,"navbar":{"links":[],"primary":{"type":"button","label":"Otwórz Paperjoy","href":"https://paperjoy.co"}},"href":""},{"language":"en","navbar":{"links":[],"primary":{"type":"button","label":"Open Paperjoy","href":"https://paperjoy.co"}},"href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paperjoy","hasAudioNarration":false,"actualSubdomain":"paperjoy","customDomains":["docs.paperjoy.co"],"gitSource":{"type":"github","owner":"norbertjurga","repo":"paperjoy-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae891cab4392014d5240346","collectionId":"3cad2a5c-5ad4-4278-b73e-79c079804298","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae891cab4392014d5240346"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae891cab4392014d5240346","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"pl","tag":"Dokumentacja API","count":14},{"language":"en","tag":"API reference","count":14},{"language":"pl","tag":"Endpointy API","count":11},{"language":"en","tag":"Endpoints","count":11},{"language":"pl","tag":"Pocztówki","count":8},{"language":"en","tag":"Postcards","count":8},{"language":"pl","tag":"Pierwsze kroki","count":5},{"language":"en","tag":"Get started","count":5},{"language":"pl","tag":"Sposoby wysyłki","count":3},{"language":"en","tag":"Ways to send","count":3},{"language":"pl","tag":"Konto","count":1},{"language":"en","tag":"Account","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--default-border-color:var(--gray-200)}.dark{--default-border-color:var(--gray-800)}#sidebar .nav-dropdown-trigger{border:0!important;background:0 0!important;box-shadow:none!important;padding-left:.375rem}#sidebar .nav-dropdown-trigger:hover{background-color:rgb(0 0 0/.04)!important}.dark #sidebar .nav-dropdown-trigger:hover{background-color:rgb(255 255 255/.06)!important}a.bg-primary-dark{background-color:#171717!important;color:#fafafa!important}a.bg-primary-dark *{color:inherit!important}.dark a.bg-primary-dark{background-color:#fafafa!important;color:#171717!important}#sidebar .nav-dropdown-trigger .nav-dropdown-item-icon,.nav-dropdown-content .nav-dropdown-item-icon{border:0!important;background:0 0!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content .nav-dropdown-item-description{display:none!important}#sidebar .nav-anchor span{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;font-weight:500;letter-spacing:-.02em;text-transform:uppercase}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/']{color:rgb(var(--primary))!important;font-weight:600!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] span{color:inherit!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] svg{background-color:rgb(var(--primary))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/']{color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href='/'] svg{background-color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}:is(#content-area[data-current-path='/'], [data-current-path='/'] #content-area):has([data-product-guide-index]){background:0 0!important;padding:0!important}:is(#content-area[data-current-path='/'], [data-current-path='/'] #content-area):has([data-product-guide-index])>div:first-child{background:0 0!important;padding-right:0!important;padding-bottom:0!important;padding-left:0!important}[data-product-guide-index] a:not(.product-guide-feature-card):not(.pj-button){background-color:#fafafa!important}.dark [data-product-guide-index] a:not(.product-guide-feature-card):not(.pj-button){background-color:#09090b!important}.product-guide-feature-card,.product-guide-feature-card>div{display:flex!important;flex-direction:column!important;justify-content:space-between!important}.product-guide-feature-card{grid-column:1/-1;min-height:260px;background:#171717!important;border:0!important;box-shadow:none!important;color:#fff!important}.product-guide-feature-card>div{flex:1}.product-guide-feature-card :is(h2, h3, p, span, svg){color:#fff!important}.product-guide-feature-card :is(svg, [class*='icon']){background-color:#fff!important;width:2em!important;height:2em!important;margin-top:2px}.product-guide-feature-card-title{font-size:1.2em;font-weight:500}.product-guide-feature-card :is(h2, h3, p, span, svg).product-guide-feature-card-description{font-size:1.05em;font-weight:400;color:rgb(var(--gray-50)/82%)!important}.dark .product-guide-feature-card :is(h2, h3, p, span, svg).product-guide-feature-card-description{color:rgb(var(--gray-50)/82%)!important}img.nav-logo{width:104px;height:32px}"}],"page":{"pagePath":"api-reference/pocztówki/wyślij-szkic","slug":"/api-reference/pocztówki/wyślij-szkic","pageMetadata":{"title":"Wyślij szkic","description":"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia `status` na `new` i `submitted_at`. Gdy sprawdzenie się nie powiedzie (`422`) albo brakuje kredytów (`402`), pocztówka zostaje szkicem i nic nie jest pobierane.\n\nWymaga nagłówka `Idempotency-Key`; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia `postcards:write`.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/postcards/{id}/submit","href":"/api-reference/pocztówki/wyślij-szkic","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia \", _jsx(_components.code, {\n children: \"status\"\n }), \" na \", _jsx(_components.code, {\n children: \"new\"\n }), \" i \", _jsx(_components.code, {\n children: \"submitted_at\"\n }), \". Gdy sprawdzenie się nie powiedzie (\", _jsx(_components.code, {\n children: \"422\"\n }), \") albo brakuje kredytów (\", _jsx(_components.code, {\n children: \"402\"\n }), \"), pocztówka zostaje szkicem i nic nie jest pobierane.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Wymaga nagłówka \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \"; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia \", _jsx(_components.code, {\n children: \"postcards:write\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Wyślij szkic","description":"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia `status` na `new` i `submitted_at`. Gdy sprawdzenie się nie powiedzie (`422`) albo brakuje kredytów (`402`), pocztówka zostaje szkicem i nic nie jest pobierane.\n\nWymaga nagłówka `Idempotency-Key`; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia `postcards:write`.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/postcards/{id}/submit","href":"/api-reference/pocztówki/wyślij-szkic","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Pocztówki"],"summary":"Wyślij szkic","description":"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia `status` na `new` i `submitted_at`. Gdy sprawdzenie się nie powiedzie (`422`) albo brakuje kredytów (`402`), pocztówka zostaje szkicem i nic nie jest pobierane.\n\nWymaga nagłówka `Idempotency-Key`; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia `postcards:write`.\n","operationId":"submitPostcard","parameters":["00992525-5514-4d2d-a595-8b05d54a65b1","bd2f424a-6945-4546-bd9a-13b713695bf3"],"responses":{"200":"786720d4-46b8-4638-a419-c2bd9d0401c9","400":"f92b1a91-39db-47f2-953b-709754cbd47c","401":"37f5383a-6aa1-45bd-97d0-0b75e52befd4","402":"b188ec26-521c-48b2-9ee6-cc35b8b23f35","403":"549c4e79-88e7-4f80-9e9e-c67f24fc05a4","404":"c07fa942-2188-404c-be72-42733af3069e","409":"fcbd753e-f5f8-46f6-9425-5a1b5fdd78c4","422":"350ed2e2-55b8-4af2-a655-89237f2ebd3d","429":"2eb77416-ac7e-4354-865b-2ce9945046f5"},"method":"post","type":"path","servers":["42836390-223e-434b-9644-aeb0580dcc33"],"security":["ff1df131-cc10-46cc-abe4-ddb1b2986599"],"path":"/api/postcards/{id}/submit","baseUrlOptions":["https://paperjoy.co"],"title":"Wyślij szkic","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"00992525-5514-4d2d-a595-8b05d54a65b1":{"name":"id","in":"path","required":true,"description":"ID pocztówki.","schema":{"type":"string","examples":["pc_MXP7a4Ni0c"],"isRequired":true,"description":"ID pocztówki.","uniqueKey":"","typeLabel":"string"}},"bd2f424a-6945-4546-bd9a-13b713695bf3":{"name":"Idempotency-Key","in":"header","required":true,"description":"Unikalny klucz tej wysyłki. Paperjoy pamięta udane odpowiedzi przez 7 dni.","schema":{"type":"string","maxLength":255,"isRequired":true,"description":"Unikalny klucz tej wysyłki. Paperjoy pamięta udane odpowiedzi przez 7 dni.","uniqueKey":"","typeLabel":"string"},"example":"submit-order-1042"}},"responses":{"786720d4-46b8-4638-a419-c2bd9d0401c9":{"description":"Zamówienie zostało złożone.","headers":{"Idempotency-Relayed":{"description":"Obecny, gdy odpowiedź jest odtworzeniem wcześniejszej odpowiedzi dla tego samego `Idempotency-Key`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","test_mode","recipient","signature","signature_id","mistake","status","submitted_at","sent_at","created_at","updated_at"],"properties":{"id":{"type":"string","examples":["pc_MXP7a4Ni0c"],"isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"test_mode":{"type":"boolean","description":"`true` dla pocztówki testowej. Pocztówki testowe są darmowe i nigdy nie są pisane ani wysyłane.","isRequired":true,"uniqueKey":"data.test_mode","typeLabel":"boolean"},"recipient":{"oneOf":[{"type":"object","description":"Podaj `first_name`, `company_name` albo oba pola.","properties":{"prefix":{"oneOf":[{"type":"string","maxLength":30,"examples":["Pani"],"uniqueKey":"data.recipient.oneOf.0.prefix.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":30,"examples":["Pani"],"uniqueKey":"data.recipient.oneOf.0.prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.oneOf.0.prefix","typeLabel":"string | null"},"first_name":{"oneOf":[{"type":"string","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.first_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.oneOf.0.first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.last_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.oneOf.0.last_name","typeLabel":"string | null"},"company_name":{"oneOf":[{"type":"string","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.company_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"uniqueKey":"data.recipient.oneOf.0.company_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient.oneOf.0.company_name","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.recipient.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.recipient.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.recipient","typeLabel":"object | null"},"signature":{"oneOf":[{"type":"string","maxLength":50,"description":"Wpisany podpis albo `null`, gdy pocztówka używa własnego podpisu.","isRequired":true,"uniqueKey":"data.signature.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":50,"description":"Wpisany podpis albo `null`, gdy pocztówka używa własnego podpisu.","isRequired":true,"uniqueKey":"data.signature.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.signature","typeLabel":"string | null"},"signature_id":{"oneOf":[{"type":"string","description":"Własny podpis użyty na pocztówce albo `null`.","examples":["sig_ZeXOkSQjTp"],"isRequired":true,"uniqueKey":"data.signature_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Własny podpis użyty na pocztówce albo `null`.","examples":["sig_ZeXOkSQjTp"],"isRequired":true,"uniqueKey":"data.signature_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.signature_id","typeLabel":"string | null"},"mistake":{"type":"boolean","description":"Czy jedno słowo jest przekreślone i napisane ponownie, aby kartka wyglądała naturalnie.","isRequired":true,"uniqueKey":"data.mistake","typeLabel":"boolean"},"status":{"type":"string","description":"Etap realizacji pocztówki. Nieznane wartości traktuj jako „w realizacji”.","enum":["draft","new","queued","rejected","pair_claimed","in_progress","pair_completed","sent"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"submitted_at":{"oneOf":[{"type":"string","format":"date-time","description":"Moment złożenia zamówienia. `null`, dopóki pocztówka jest szkicem.","isRequired":true,"uniqueKey":"data.submitted_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Moment złożenia zamówienia. `null`, dopóki pocztówka jest szkicem.","isRequired":true,"uniqueKey":"data.submitted_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.submitted_at","typeLabel":"string\u003cdate-time> | null"},"sent_at":{"oneOf":[{"type":"string","format":"date-time","description":"Moment nadania pocztówki. `null`, dopóki status nie zmieni się na `sent`.","isRequired":true,"uniqueKey":"data.sent_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Moment nadania pocztówki. `null`, dopóki status nie zmieni się na `sent`.","isRequired":true,"uniqueKey":"data.sent_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.sent_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"},"address":{"oneOf":[{"type":"object","description":"Adres dostawy. Może być `null` tylko w szkicu.","required":["line_1","postal_code","country","city"],"properties":{"line_1":{"type":"string","maxLength":255,"description":"Ulica i numer budynku.","examples":["ul. Marszałkowska 10"],"isRequired":true,"uniqueKey":"data.address.oneOf.0.line_1","typeLabel":"string"},"postal_code":{"type":"string","pattern":"^\\d{2}-\\d{3}$","examples":["00-001"],"isRequired":true,"uniqueKey":"data.address.oneOf.0.postal_code","typeLabel":"string"},"country":{"type":"string","enum":["PL"],"isRequired":true,"uniqueKey":"data.address.oneOf.0.country","typeLabel":"enum\u003cstring>"},"city":{"type":"string","maxLength":255,"examples":["Warszawa"],"isRequired":true,"uniqueKey":"data.address.oneOf.0.city","typeLabel":"string"},"line_2":{"oneOf":[{"type":"string","maxLength":255,"description":"Numer lokalu, piętro lub inna informacja.","examples":["m. 4"],"uniqueKey":"data.address.oneOf.0.line_2.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Numer lokalu, piętro lub inna informacja.","examples":["m. 4"],"uniqueKey":"data.address.oneOf.0.line_2.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.address.oneOf.0.line_2","typeLabel":"string | null"}},"uniqueKey":"data.address.oneOf.0","typeLabel":"object"},{"type":"null","description":"Adres dostawy. Może być `null` tylko w szkicu.","uniqueKey":"data.address.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.address","typeLabel":"object | null"},"content":{"oneOf":[{"type":"string","maxLength":300,"description":"Treść kartki. Może być `null` tylko w szkicu.","uniqueKey":"data.content.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":300,"description":"Treść kartki. Może być `null` tylko w szkicu.","uniqueKey":"data.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.content","typeLabel":"string | null"},"font_id":{"oneOf":[{"type":"string","description":"Pismo. Może być `null` tylko w szkicu.","enum":["font-1","font-2"],"uniqueKey":"data.font_id.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Pismo. Może być `null` tylko w szkicu.","uniqueKey":"data.font_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.font_id","typeLabel":"enum\u003cstring> | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"pc_MXP7a4Ni0c","test_mode":true,"recipient":{"prefix":"Pani","first_name":"\u003cstring>","last_name":"\u003cstring>","company_name":"\u003cstring>"},"signature":"\u003cstring>","signature_id":"sig_ZeXOkSQjTp","mistake":true,"status":"draft","submitted_at":"2023-11-07T05:31:56Z","sent_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","address":{"line_1":"ul. Marszałkowska 10","postal_code":"00-001","country":"PL","city":"Warszawa","line_2":"m. 4"},"content":"\u003cstring>","font_id":"font-1"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f92b1a91-39db-47f2-953b-709754cbd47c":{"description":"Brakuje nagłówka `Idempotency-Key`.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Idempotency-Key header is required to create or submit a postcard."},"examples":{"Example":{"title":"Example","value":{"message":"Idempotency-Key header is required to create or submit a postcard."}}},"exampleType":"examples"}},"exampleType":"examples"},"37f5383a-6aa1-45bd-97d0-0b75e52befd4":{"description":"Brak klucza API albo klucz jest nieprawidłowy, unieważniony lub wygasł.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Unauthenticated."},"examples":{"Example":{"title":"Example","value":{"message":"Unauthenticated."}}},"exampleType":"examples"}},"exampleType":"examples"},"b188ec26-521c-48b2-9ee6-cc35b8b23f35":{"description":"Konto ma mniej niż jeden kredyt. Saldo jest sprawdzane tylko w trybie live.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"You need at least 1 credit to create a postcard."},"examples":{"Example":{"title":"Example","value":{"message":"You need at least 1 credit to create a postcard."}}},"exampleType":"examples"}},"exampleType":"examples"},"549c4e79-88e7-4f80-9e9e-c67f24fc05a4":{"description":"Klucz API nie ma wymaganego uprawnienia albo zasób należy do kogoś innego.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"This action is unauthorized."},"examples":{"Example":{"title":"Example","value":{"message":"This action is unauthorized."}}},"exampleType":"examples"}},"exampleType":"examples"},"c07fa942-2188-404c-be72-42733af3069e":{"description":"Zasób nie istnieje albo należy do drugiego trybu.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Not found."},"examples":{"Example":{"title":"Example","value":{"message":"Not found."}}},"exampleType":"examples"}},"exampleType":"examples"},"fcbd753e-f5f8-46f6-9425-5a1b5fdd78c4":{"description":"Pocztówka nie jest już szkicem albo `Idempotency-Key` został użyty z innym żądaniem.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Postcard pc_MXP7a4Ni0c has already been submitted (status: new). Only drafts can be changed, submitted, or deleted."},"examples":{"Example":{"title":"Example","value":{"message":"Postcard pc_MXP7a4Ni0c has already been submitted (status: new). Only drafts can be changed, submitted, or deleted."}}},"exampleType":"examples"}},"exampleType":"examples"},"350ed2e2-55b8-4af2-a655-89237f2ebd3d":{"description":"Pole jest nieprawidłowe, tekst nie mieści się na kartce lub kopercie albo `Idempotency-Key` jest dłuższy niż 255 znaków.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message","errors"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.errors.additionalProperties","typeLabel":"string[]"},"isRequired":true,"uniqueKey":"oneOf.0.errors","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"field":{"title":"field","value":{"message":"The selected font id is invalid.","errors":{"font_id":["The selected font id is invalid."]}}},"card_fit":{"title":"card_fit","value":{"message":"The content does not fit on the postcard. Shorten it or remove blank lines.","errors":{"content":["The content does not fit on the postcard. Shorten it or remove blank lines."]}}},"envelope_fit":{"title":"envelope_fit","value":{"message":"The sender or recipient address does not fit on the envelope.","errors":{"address":["The sender or recipient address does not fit on the envelope."]}}},"draft_limit":{"title":"draft_limit","value":{"message":"You already have 100 open drafts. Submit or delete some of them before saving another draft.","errors":{"draft":["You already have 100 open drafts. Submit or delete some of them before saving another draft."]}}},"signature_unavailable":{"title":"signature_unavailable","value":{"message":"The selected signature is unavailable or is not active for your plan.","errors":{"signature_id":["The selected signature is unavailable or is not active for your plan."]}}}},"exampleType":"examples"}},"exampleType":"examples"},"2eb77416-ac7e-4354-865b-2ce9945046f5":{"description":"Przekroczono limit żądań. Odczekaj przed ponowieniem.","headers":{"Retry-After":{"description":"Liczba sekund, po której można ponowić żądanie.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"message":"Too Many Attempts."},"examples":{"Example":{"title":"Example","value":{"message":"Too Many Attempts."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"ff1df131-cc10-46cc-abe4-ddb1b2986599":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Klucz API Paperjoy. Klucze z prefiksem `pj_test_` działają w trybie testowym, a z `pj_live_` w trybie live.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"42836390-223e-434b-9644-aeb0580dcc33":{"url":"https://paperjoy.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Klucz API Paperjoy. Klucze z prefiksem `pj_test_` działają w trybie testowym, a z `pj_live_` w trybie live.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Klucz API Paperjoy. Klucze z prefiksem `pj_test_` działają w trybie testowym, a z `pj_live_` w trybie live.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"paperjoy","siteName":"Paperjoy","title":"Wyślij szkic - Paperjoy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pl":{"href":"/api-reference/pocztówki/wyślij-szkic","matchLevel":0},"en":{"href":"/en","matchLevel":3}}},"lastModified":"2026-11-02T13:36:14.816Z","originalFileLocation":"api-reference/pocztówki/wyślij-szkic.mdx","locale":"pl"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane. Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Paperjoy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Wyślij szkic - Paperjoy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane. Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paperjoy Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paperjoy.co/api-reference/pocztówki/wyślij-szkic\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paperjoy.mintlify.app/_mintlify/api/og/v2?division=Endpointy+API\u0026amp;title=Wy%C5%9Blij+szkic\u0026amp;description=Sk%C5%82ada+zam%C3%B3wienie+ze+szkicu.+Paperjoy+sprawdza+szkic+tak+jak+now%C4%85+poczt%C3%B3wk%C4%99%2C+tak%C5%BCe+pod+k%C4%85tem+zmieszczenia+na+kartce+i+kopercie%2C+pobiera+jeden+kredyt+%28tylko+live\u0026amp;theme=f50a3cf5b4b6d1969d867276\u0026amp;signature=4dade6a43a1117a935d8694b2c905e89b79526d91deffdb0aaeb2c8e0b6e4bbc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Wyślij szkic - Paperjoy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane. Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paperjoy.mintlify.app/_mintlify/api/og/v2?division=Endpointy+API\u0026amp;title=Wy%C5%9Blij+szkic\u0026amp;description=Sk%C5%82ada+zam%C3%B3wienie+ze+szkicu.+Paperjoy+sprawdza+szkic+tak+jak+now%C4%85+poczt%C3%B3wk%C4%99%2C+tak%C5%BCe+pod+k%C4%85tem+zmieszczenia+na+kartce+i+kopercie%2C+pobiera+jeden+kredyt+%28tylko+live\u0026amp;theme=f50a3cf5b4b6d1969d867276\u0026amp;signature=4dade6a43a1117a935d8694b2c905e89b79526d91deffdb0aaeb2c8e0b6e4bbc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/paperjoy/h4jTuCJJKXjK5S8U/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paperjoy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paperjoy.co/api-reference/pocztówki/wyślij-szkic\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://paperjoy.co/#organization\",\"name\":\"Paperjoy\",\"legalName\":\"Paperjoy Norbert Jurga\",\"url\":\"https://paperjoy.co/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://paperjoy.co/icon-512.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paperjoy.co#website\",\"name\":\"Paperjoy\",\"url\":\"https://docs.paperjoy.co\",\"publisher\":{\"@id\":\"https://paperjoy.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic#webpage\",\"url\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic\",\"name\":\"Wyślij szkic\",\"description\":\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane. Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.\",\"dateModified\":\"2026-11-02T13:36:14.816Z\",\"isPartOf\":{\"@id\":\"https://docs.paperjoy.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dokumentacja API\",\"item\":\"https://docs.paperjoy.co/reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpointy API\",\"item\":\"https://docs.paperjoy.co/api-reference/konto/pobierz-konto\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Wyślij szkic\",\"item\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic#apireference\",\"headline\":\"Wyślij szkic\",\"name\":\"Wyślij szkic\",\"description\":\"Składa zamówienie ze szkicu. Paperjoy sprawdza szkic tak jak nową pocztówkę, także pod kątem zmieszczenia na kartce i kopercie, pobiera jeden kredyt (tylko live), ustawia status na new i submitted_at. Gdy sprawdzenie się nie powiedzie (422) albo brakuje kredytów (402), pocztówka zostaje szkicem i nic nie jest pobierane. Wymaga nagłówka Idempotency-Key; ponowienie z tym samym kluczem zwraca pierwotną odpowiedź i nie pobiera drugiego kredytu. Wlicza się do dziennego limitu 100 pocztówek. Wymaga uprawnienia postcards:write.\",\"url\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paperjoy.co/api-reference/poczt%C3%B3wki/wy%C5%9Blij-szkic#webpage\"},\"dateModified\":\"2026-11-02T13:36:14.816Z\",\"publisher\":{\"@id\":\"https://paperjoy.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paperjoy.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paperjoy\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Paperjoy","nav":{"global":{"anchors":[{"anchor":"Paperjoy","icon":"house","href":"/"},{"anchor":"API","icon":"square-terminal","href":"/reference/introduction"},{"anchor":"Changelog","icon":"scroll-text","href":"/changelog"}]},"directory":"card","languages":[{"language":"pl","default":true,"navbar":{"links":[],"primary":{"type":"button","label":"Otwórz Paperjoy","href":"https://paperjoy.co"}},"groups":[{"group":"Pierwsze kroki","icon":"rocket","expanded":true,"pages":[{"title":"Dokumentacja Paperjoy","sidebarTitle":"Strona główna","mode":"frame","href":""},{"title":"Jak działa Paperjoy","icon":"lightbulb","href":"/getting-started/introduction"},{"title":"Szybki start: pierwsza pocztówka przez API","sidebarTitle":"Szybki start","icon":"rocket","href":"/getting-started/quickstart"},{"title":"Tryb testowy","icon":"flask-conical","href":"/getting-started/test-mode"},{"title":"Klucze API","icon":"key-round","href":"/getting-started/authentication"}]},{"group":"Sposoby wysyłki","icon":"send","expanded":true,"pages":[{"title":"Edytor","icon":"pen-line","href":"/integrations/editor"},{"title":"Integracja Paperjoy z Zapier","sidebarTitle":"Zapier","icon":"workflow","href":"/integrations/zapier"},{"title":"Serwer MCP Paperjoy dla Claude i asystentów AI","sidebarTitle":"Serwer MCP","icon":"bot","href":"/integrations/mcp"}]},{"group":"Pocztówki","icon":"mail","expanded":true,"pages":[{"title":"Treść i wygląd kartki","icon":"pen-line","href":"/postcards/write"},{"title":"Własne podpisy","icon":"signature","href":"/postcards/custom-signatures"},{"title":"Adres i koperta","icon":"map-pin","href":"/postcards/supported-countries"},{"title":"Podgląd pocztówki","icon":"image","href":"/postcards/preview"},{"title":"Utwórz pocztówkę","icon":"send","href":"/postcards/create"},{"title":"Szkice pocztówek: przygotuj, sprawdź i wyślij później","sidebarTitle":"Szkice","icon":"file-pen","href":"/postcards/drafts"},{"title":"Śledzenie pocztówek","icon":"list","href":"/postcards/list-and-retrieve"},{"title":"Statusy pocztówek","icon":"route","href":"/postcards/statuses"}]},{"group":"Konto","icon":"wallet","expanded":true,"pages":[{"title":"Kredyty i rozliczenia","icon":"wallet","href":"/account/credits-and-billing"}]},{"group":"Dokumentacja API","icon":"braces","expanded":true,"pages":[{"title":"Przegląd API Paperjoy","sidebarTitle":"Przegląd API","icon":"braces","href":"/reference/introduction"},{"title":"Błędy i limity","icon":"circle-alert","href":"/reference/errors-and-rate-limits"},{"group":"Endpointy API","pages":[{"title":"Pobierz konto","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/user","href":"/api-reference/konto/pobierz-konto"},{"title":"Utwórz pocztówkę","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/postcards","href":"/api-reference/pocztówki/utwórz-pocztówkę"},{"title":"Podgląd pocztówki","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/postcards/preview","href":"/api-reference/pocztówki/podgląd-pocztówki"},{"title":"Lista pocztówek","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/postcards","href":"/api-reference/pocztówki/lista-pocztówek"},{"title":"Pobierz pocztówkę","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/postcards/{id}","href":"/api-reference/pocztówki/pobierz-pocztówkę"},{"title":"Edytuj szkic","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/postcards/{id}","href":"/api-reference/pocztówki/edytuj-szkic"},{"title":"Usuń szkic","description":"Trwale usuwa szkic. Wysłanych pocztówek nie można usunąć (`409`). Wymaga uprawnienia `postcards:write`.","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/postcards/{id}","href":"/api-reference/pocztówki/usuń-szkic"},{"title":"Wyślij szkic","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/postcards/{id}/submit","href":"/api-reference/pocztówki/wyślij-szkic"},{"title":"Lista podpisów","description":"Zwraca własne podpisy Twojej organizacji, od najnowszych, także te, które wciąż przygotowujemy. Wymaga uprawnienia `signatures:read`.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/signatures","href":"/api-reference/podpisy/lista-podpisów"},{"title":"Pobierz podpis","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/signatures/{id}","href":"/api-reference/podpisy/pobierz-podpis"},{"title":"Usuń podpis","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /api/signatures/{id}","href":"/api-reference/podpisy/usuń-podpis"}]},{"title":"Historia zmian","href":"/changelog"}]}]},{"language":"en","navbar":{"links":[],"primary":{"type":"button","label":"Open Paperjoy","href":"https://paperjoy.co"}},"pages":[{"title":"en","href":"/en"}]}]},"basePath":"","title":"Wyślij szkic - Paperjoy","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}