PATCH/v1/templates/{id}

Rename or move a template

Scope templates.write

Path parameters

idstringrequired

Body

namestringmin length 1max length 160

folderIdstring or null

Returns

10 fields of the 200 answer

idstringrequired

namestringrequired

folderIdstring or nullrequired

productIdstringrequired

productSpecificationIdstringrequired

draftobjectrequired

3 fields

revisionintegerrequired

updatedAtdate-timerequired

updatedByIdstring or nullrequired

latestVersionobject or nullrequired

6 fields

idstringrequired

numberintegerrequired

publishedAtdate-timerequired

publishedByTypeenumrequired

USERAPI_KEY

publishedByIdstringrequired

staticLayerStatusenumrequired

PENDINGREADYFAILED

archivedAtdate-time or nullrequired

createdAtdate-timerequired

updatedAtdate-timerequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

404Not found

422Validation failed

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

curl -X PATCH https://api.postbuddy.nl/v1/templates/tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K \ -H "Authorization: Bearer $POSTBUDDY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Welcome card", "folderId": "tf_01J9Y2K8QF4T6W8Z0B2D4F6H8K" }'

import { PostBuddyClient } from '@postbuddy/sdk'; const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! }); const result = await client.templates.update('tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K', { body: { name: 'Welcome card', folderId: 'tf_01J9Y2K8QF4T6W8Z0B2D4F6H8K', }, });

import os from postbuddy import Client client = Client(os.environ["POSTBUDDY_API_KEY"]) result = client.templates.update("tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K", { "name": "Welcome card", "folderId": "tf_01J9Y2K8QF4T6W8Z0B2D4F6H8K", })

{ "id": "tpl_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "name": "Welcome card", "folderId": "tf_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "productId": "prd_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "productSpecificationId": "psp_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "draft": { "revision": 1, "updatedAt": "2026-10-16T09:14:02.000Z", "updatedById": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K" }, "latestVersion": { "id": "tv_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "number": 1, "publishedAt": "2026-10-16T09:14:02.000Z", "publishedByType": "USER", "publishedById": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "staticLayerStatus": "READY" }, "archivedAt": "2026-10-16T09:14:02.000Z", "createdAt": "2026-10-16T09:14:02.000Z", "updatedAt": "2026-10-16T09:14:02.000Z" }

{ "type": "https://docs.postbuddy.nl/errors/validation_failed", "title": "Validation failed", "status": 422, "code": "validation_failed", "detail": "Validation failed", "requestId": "req_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "errors": [ { "field": "recipient.postalCode", "code": "invalid_string", "message": "Invalid postal code" } ] }