Skip to main content
PATCH
Update pass

Authorizations

Authorization
string
header
required

API key authentication. Include your API key as a Bearer token.

Example: Bearer sk_prod_xxxxxx

Get your API key from the Stell Dashboard.

Path Parameters

passId
string
required

Body

application/json

Fields to update on an existing pass.

creationSource
object

Override creation source tracking

templateOverrides
object

Template overrides for dynamic pass customization based on business logic (e.g., member tiers, promotions). All fields are optional.

notificationMessage
string

Message shown when the pass is updated (wallet push / pass refresh)

externalId
string

External system reference (e.g., CRM user ID)

semanticTagOverrides
object

Semantic tags for Apple Wallet passes: seating, flight, event and location details that Wallet and Siri use for suggestions. All fields are optional; send the ones that apply to your pass type.

membershipStatus
string

Merchant-defined account status (e.g., "Active", "Suspended", "On Hold")

Maximum string length: 255
externalReference
string

Additional external reference for integration with external systems

Maximum string length: 200
payload
string

NFC or QR payload (defaults to pass ID if not provided)

loyaltyState
object

Loyalty program state information

activationDate
string<date-time> | null

Date when the pass becomes active. Pass null to clear.

status
enum<string>

Update pass status (ACTIVE enables pass, VOIDED permanently disables)

Available options:
PREACTIVE,
ACTIVE,
INACTIVE,
VOIDED,
REVOKED,
EXPIRED
customer
object

Update customer information

expirationDate
string<date-time> | null

Date when the pass expires. Pass null to clear.

Response

200 response

Response envelope carrying a pass.

data
PassModel · object
required

Digital pass issued to a customer.

requestId
string
required

Unique request identifier for debugging

Pattern: ^[0-9A-Z]{26}$