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

Query Parameters

Body

application/json

Fields to update on an existing pass.

externalReference
string

Additional external reference for integration with external systems

Maximum string length: 200
templateOverrides
object

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

payload
string

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

loyaltyState
object

Loyalty program state information

notificationMessage
string

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

externalId
string

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

activationDate
string<date-time> | null

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

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
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}$