API reference · Templates

Update a template's passes

POST/v1/templates/{slug}/update-passes1 operation a passSafe to retry with Idempotency-Key

Gives every pass on an older version the template's latest design, in the background. Installed passes refresh.

Path

slugstringrequired

The template's slug. org:<slug> for one your organization shares with this workspace (those can only be read).

Answer

202Started

Follow it with Get a template: update.status goes from sending to completed, or stopped if it couldn't go on. failed passes kept their old design.

Errors

Every error has the same shape: see Errors.

Status	Code	When
403	`organization_template`	It's your organization's: change it in the dashboard, or duplicate it to make your own.
404	`not_found`	No template with that slug here.
409	`template_update_in_progress`	Its passes are already being updated.
409	`idempotency_conflict`	The Idempotency-Key was already used for a different request.
422	`nothing_to_update`	Every pass made from it is on its latest version.
429	`template_update_over_allowance`	It would go past this month's operations. `preview` says what's left.

Request

curl -X POST "https://api.walletpassapi.com/v1/templates/gold-member/update-passes" \
  -H "Authorization: Bearer $WALLET_API_KEY"

const res = await fetch("https://api.walletpassapi.com/v1/templates/gold-member/update-passes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WALLET_API_KEY}`,
  },
});
const data = await res.json();

import os

import requests

res = requests.post(
    "https://api.walletpassapi.com/v1/templates/gold-member/update-passes",
    headers={"Authorization": f"Bearer {os.environ['WALLET_API_KEY']}"},
)
data = res.json()

<?php

$ch = curl_init("https://api.walletpassapi.com/v1/templates/gold-member/update-passes");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("WALLET_API_KEY"),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

202 Started

{
  "update": {
    "id": "bc_q4n7w2k9x1m3p5r8",
    "status": "sending",
    "total": 1200,
    "updated": 0,
    "skipped": 0,
    "failed": 0,
    "lastError": null,
    "createdAt": "2026-10-08T19:31:12.000Z",
    "completedAt": null
  }
}