Problem description
Cross-API consistency issues between sim-swap.yaml and sim-swap-subscriptions.yaml, none blocking on its own:
- Error codes for the same identifier-resolution outcome differ: subscriptions'
403/422 include INVALID_TOKEN_CONTEXT/UNSUPPORTED_IDENTIFIER; sim-swap's don't.
- Subject vocabulary: subscriptions' section header and text say "device"; sim-swap's header says "phone number" but its own 422 examples say "The device cannot be identified."
CreateSubscriptionBadRequest400.code still lists INVALID_TOKEN, but its example (GENERIC_400_INVALID_TOKEN) was removed.
- Three id styles in
sim-swap-subscriptions.yaml: SubscriptionId.example (qs15-h556-rt89-1298), operation examples ('1119920371'), and the new Subscription schema example (UUID 550e8400-…).
- Casing:
info.title "SIM Swap" vs "Sim Swap Subscriptions"; tags follow the same split.
sim-swap defines latestSimChange inline with a duplicated RFC 3339 reference; sim-swap-subscriptions has a reusable DateTime schema.
Expected action
Address when the definitions are next edited.
Additional context
Raised during Release Management review of the r4.1 rc snapshot (#283).
Problem description
Cross-API consistency issues between
sim-swap.yamlandsim-swap-subscriptions.yaml, none blocking on its own:403/422includeINVALID_TOKEN_CONTEXT/UNSUPPORTED_IDENTIFIER; sim-swap's don't.CreateSubscriptionBadRequest400.codestill listsINVALID_TOKEN, but its example (GENERIC_400_INVALID_TOKEN) was removed.sim-swap-subscriptions.yaml:SubscriptionId.example(qs15-h556-rt89-1298), operation examples ('1119920371'), and the newSubscriptionschema example (UUID550e8400-…).info.title"SIM Swap" vs "Sim Swap Subscriptions"; tags follow the same split.sim-swapdefineslatestSimChangeinline with a duplicated RFC 3339 reference;sim-swap-subscriptionshas a reusableDateTimeschema.Expected action
Address when the definitions are next edited.
Additional context
Raised during Release Management review of the r4.1 rc snapshot (#283).