Journey Docs
Partner API ExplorerLoyaltyTiers

Reorder the tier ladder

Required scopepartner:loyalty:programs:write
PUT
/v1/partner/loyalty/programs/{programExternalId}/tiers/order

Full replacement of tier ordering: send every tier external id in the order they should rank, lowest first.

Authorization

headerAuthorizationBearer <token>

WorkOS access token (JWT) for a user who is a member of the partner organization. The organization the request is scoped to is taken from the token, not from a header or query parameter.

Only a JWT is accepted in this header. A Journey jny_ API key sent as a bearer token is rejected with 401 Invalid or expired token; send it in X-API-Key instead.

WorkOS organization API keys are not accepted yet.

Path Parameters

programExternalId*string

External id of the loyalty program that owns the tier ladder.

Query Parameters

organizationId?string

External organization id (HXP UUID or WorkOS organization id). Only Journey superadmin callers may set it; for a partner credential the organization is taken from the credential and this parameter is ignored.

Request Body

application/json
  1. body
tierExternalIds*array<string>
Items1 <= items

Response Body

The reordered ladder.

curl -X PUT 'https://api-prd.cf.journey.com/v1/partner/loyalty/programs/string/tiers/order' \  -H 'Content-Type: application/json' \  -d '{  "tierExternalIds": [    "string"  ]}'
Empty