Skip to main content
GET https://api.craftkit.dev/v1/embed/renders/:id/download
Streams the rendered PDF bytes from private storage. Despite the embed/ namespace, this endpoint authenticates with your ck_live_ key as the partner secret — it does not require an embed session JWT. Use it when you do not want to rely on the public-bucket downloadUrl.
The sibling metadata endpoint GET /v1/embed/renders/:id does require an embed session JWT with strict session ownership and is not reachable with a partner key. For headless metadata, poll GET /v1/renders/:id.

​
Authorization

​
Authorization
string
required
Bearer ck_live_… — accepted as the partner secret for the render’s project.

​
Path parameters

​
id
string
required
The render id.

​
Response

200 with Content-Type: application/pdf and the PDF bytes (Content-Disposition: inline, Cache-Control: private, max-age=3600).
StatuscodeMeaning
401invalid_credentialsMissing/invalid partner key.
404—Render not found in this key’s project, or no asset yet.
cURL
curl https://api.craftkit.dev/v1/embed/renders/$RENDER_ID/download \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY" \
  --output handover.pdf