Kun 720 kr./år – spar 20%
"},"price":{"type":"number","description":"Regular price","example":99},"discountPrice":{"type":"number","description":"Discounted price if applicable","example":75},"discountCode":{"type":"string","description":"Applied discount code","example":""},"periodText":{"type":"string","description":"Period text (e.g., \"måned\", \"month\")","example":"måned"},"tag":{"type":"string","description":"Tag for categorization","example":""},"selected":{"type":"boolean","description":"Whether this subscription is pre-selected","example":true},"features":{"type":"array","items":{"type":"string"},"description":"List of features included in this subscription","example":["Daglige nyheder om tech, startups og scaleups","Eksklusive interviews med founders"]},"buttonText":{"type":"string","description":"Custom button text","example":"KØB ADGANG"},"readMoreText":{"type":"string","description":"Read more link text","example":"Læs mere"},"preferBusiness":{"type":"boolean","description":"Whether this option is preferred for business customers","example":false},"url":{"type":"string","description":"External URL for more information","example":"https://24victoria.dk/business"}},"required":["id","sku","poId","title","description","discountCode","periodText","tag","selected"]}},"features":{"type":"array","items":{"type":"string"},"description":"General features displayed on the paywall","example":["Danmarks nyhedsmedie om techvirksomeder. startups & scaleups"]},"mainColor":{"type":"string","description":"Main brand color in hex format","example":"#3377fe"},"headline":{"type":"string","description":"Paywall headline text","example":"Login for at læse artiklen"},"logoUrl":{"type":"string","description":"URL to the vendor logo","example":"https://assets.sesamy.com/vendor-assets/24victoria/ad29ee3a-4648-453e-92ad-a2d43c68cd39.svg"},"footerPaymentMethods":{"type":"array","items":{"type":"string"},"description":"Payment methods displayed in the footer","example":["visa","mastercard","google-pay","apple-pay"]},"singlePurchase":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Whether single purchase is enabled","example":true},"title":{"type":"string","description":"Single purchase option title","example":"Buy Now"},"description":{"type":"string","description":"Single purchase option description","example":"One-time purchase"},"discountCode":{"type":"string","description":"Applied discount code for single purchase","example":""}},"required":["enabled","title","description","discountCode"]}},"required":["id","vendorId","currency","version","settings","showLoginButton","subscriptions","features","footerPaymentMethods"]},"AccessList":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the access list","example":"src_123abc"},"name":{"type":"string","description":"Name of the access list","example":"My Partner API"},"description":{"type":"string","description":"Description of the access list","example":"Purchases from partner system"},"type":{"type":"string","enum":["CSV_FILE_OLD","CSV_FILE","CSV_TRANSACTIONS","CLAIMED","MANUAL","HOOK","BASIC_API"],"description":"Type of access list","example":"MANUAL"},"status":{"type":"string","enum":["DRAFT","ACTIVE","CANCELED"],"description":"Status of the access list","example":"ACTIVE"},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false}},"required":["id","name","type","status"]},"CreateAccessList":{"type":"object","properties":{"name":{"type":"string","description":"Name of the access list","example":"My Partner API"},"description":{"type":"string","description":"Description of the access list","example":"Purchases from partner system"},"type":{"type":"string","enum":["CSV_FILE_OLD","CSV_FILE","CSV_TRANSACTIONS","CLAIMED","MANUAL","HOOK","BASIC_API"],"description":"Type of access list","example":"MANUAL"},"status":{"type":"string","enum":["DRAFT","ACTIVE","CANCELED"],"description":"Status of the access list","example":"ACTIVE"},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false}},"required":["name","type","status"]},"UpdateAccessList":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the access list","example":"src_123abc"},"name":{"type":"string","description":"Name of the access list","example":"My Partner API"},"description":{"type":"string","description":"Description of the access list","example":"Purchases from partner system"},"type":{"type":"string","enum":["CSV_FILE_OLD","CSV_FILE","CSV_TRANSACTIONS","CLAIMED","MANUAL","HOOK","BASIC_API"],"description":"Type of access list","example":"MANUAL"},"status":{"type":"string","enum":["DRAFT","ACTIVE","CANCELED"],"description":"Status of the access list","example":"ACTIVE"},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false}}},"GrantAddress":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"zip":{"type":"string"},"country":{"type":"string"},"co":{"type":"string"}}},"Grant":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the grant","example":"grant_123abc"},"source":{"type":"string","description":"Source/access list ID","example":"src_123abc"},"email":{"type":"string","format":"email","description":"Email address of the user","example":"user@example.com"},"userId":{"type":"string","description":"User ID","example":"pub_user_123"},"publisherUserId":{"type":"string","description":"Publisher user ID","example":"pub_user_123"},"sku":{"type":"string","description":"Product SKU","example":"premium-article-123"},"poId":{"type":"string","description":"Purchase option ID","example":"po_123abc"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","CANCELED"],"description":"Status of the grant","example":"ACTIVE"},"startsAt":{"type":"string","format":"date-time","description":"Grant start date","example":"2024-01-01T00:00:00Z"},"endsAt":{"type":"string","format":"date-time","description":"Grant end date","example":"2024-12-31T23:59:59Z"},"firstName":{"type":"string","description":"First name","example":"John"},"lastName":{"type":"string","description":"Last name","example":"Doe"},"phone":{"type":"string","description":"Phone number","example":"+1234567890"},"deliveryAddress":{"$ref":"#/components/schemas/GrantAddress"},"billingAddress":{"$ref":"#/components/schemas/GrantAddress"},"publisherPurchaseId":{"type":"string","description":"Publisher purchase ID","example":"pub_purchase_123"},"notes":{"type":"string","description":"Notes about the grant","example":"Bulk purchase"},"extraFields":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional custom fields","example":{"custom_field":"value"}},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false}},"required":["id","source","email","sku","poId","status"]},"CreateGrant":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Email address of the user","example":"user@example.com"},"userId":{"type":"string","description":"User ID","example":"pub_user_123"},"publisherUserId":{"type":"string","description":"Publisher user ID","example":"pub_user_123"},"sku":{"type":"string","minLength":1,"description":"Product SKU (required)","example":"premium-article-123"},"poId":{"type":"string","minLength":1,"description":"Purchase option ID (required)","example":"po_123abc"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","CANCELED"],"description":"Status of the grant","example":"ACTIVE"},"startsAt":{"type":"string","format":"date-time","description":"Grant start date","example":"2024-01-01T00:00:00Z"},"endsAt":{"type":"string","format":"date-time","description":"Grant end date","example":"2024-12-31T23:59:59Z"},"firstName":{"type":"string","description":"First name","example":"John"},"lastName":{"type":"string","description":"Last name","example":"Doe"},"phone":{"type":"string","description":"Phone number","example":"+1234567890"},"deliveryAddress":{"$ref":"#/components/schemas/GrantAddress"},"billingAddress":{"$ref":"#/components/schemas/GrantAddress"},"publisherPurchaseId":{"type":"string","description":"Publisher purchase ID","example":"pub_purchase_123"},"notes":{"type":"string","description":"Notes about the grant","example":"Bulk purchase"},"extraFields":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional custom fields","example":{"custom_field":"value"}},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false},"source":{"type":"string","description":"Source/access list ID","example":"src_123abc"}},"required":["email","sku","poId","status","source"]},"UpdateGrant":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Email address of the user","example":"user@example.com"},"userId":{"type":"string","description":"User ID","example":"pub_user_123"},"publisherUserId":{"type":"string","description":"Publisher user ID","example":"pub_user_123"},"sku":{"type":"string","description":"Product SKU","example":"premium-article-123"},"poId":{"type":"string","description":"Purchase option ID","example":"po_123abc"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","CANCELED"],"description":"Status of the grant","example":"ACTIVE"},"startsAt":{"type":"string","format":"date-time","description":"Grant start date","example":"2024-01-01T00:00:00Z"},"endsAt":{"type":"string","format":"date-time","description":"Grant end date","example":"2024-12-31T23:59:59Z"},"firstName":{"type":"string","description":"First name","example":"John"},"lastName":{"type":"string","description":"Last name","example":"Doe"},"phone":{"type":"string","description":"Phone number","example":"+1234567890"},"deliveryAddress":{"$ref":"#/components/schemas/GrantAddress"},"billingAddress":{"$ref":"#/components/schemas/GrantAddress"},"publisherPurchaseId":{"type":"string","description":"Publisher purchase ID","example":"pub_purchase_123"},"notes":{"type":"string","description":"Notes about the grant","example":"Bulk purchase"},"extraFields":{"type":"object","additionalProperties":{"type":"string"},"description":"Additional custom fields","example":{"custom_field":"value"}},"excludeFromStats":{"type":"boolean","description":"Whether to exclude from statistics","example":false}}}},"parameters":{}},"paths":{"/management/vendors":{"get":{"tags":["Vendors"],"security":[{"OpenID":[]}],"responses":{"200":{"description":"A list of vendors","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Vendor"}}}}}}},"post":{"tags":["Vendors"],"security":[{"OpenID":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"},"website":{"type":"string"},"country":{"type":"string","minLength":2,"maxLength":2}},"required":["name","id","website","country"]}}}},"responses":{"201":{"description":"Status"}}}},"/management/vendors/:vendorId/token-handler":{"get":{"tags":["Vendors"],"security":[{"OpenID":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"vendorId","in":"path"}],"responses":{"200":{"description":"Current token handler settings for the vendor","content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string"},"authHostname":{"type":"string"},"hasEncryptionSecret":{"type":"boolean"}},"required":["hasEncryptionSecret"]}}}},"404":{"description":"Vendor not found or settings unavailable"},"502":{"description":"Failed to fetch settings from upstream"}}},"put":{"tags":["Vendors"],"security":[{"OpenID":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"vendorId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string","description":"OAuth client ID for this vendor"},"authHostname":{"type":"string","description":"Hostname that maps to this vendor, e.g. auth.vendor.com or localhost:5173"}},"required":["clientId","authHostname"]}}}},"responses":{"200":{"description":"Updated token handler settings","content":{"application/json":{"schema":{"type":"object","properties":{"clientId":{"type":"string"},"authHostname":{"type":"string"}},"required":["clientId","authHostname"]}}}},"502":{"description":"Failed to fetch existing settings from upstream"}}}},"/management/bills":{"get":{"tags":["Bills"],"security":[{"OpenID":["bills:read"]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","enum":["DRAFT","PENDING","PAID","RETRYING","OVERDUE","CANCELED","EXPIRED","DELETED","VOIDED"]},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"contractId","in":"query"}],"responses":{"200":{"description":"Retrieve the users bills","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Bill"}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/bills/{id}":{"get":{"tags":["Bills"],"security":[{"OpenID":["bills:read"]}],"parameters":[{"schema":{"type":"string","example":"1d78271264b9c76d5842911dd70b4353"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Retrieve the users bills","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bill"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/contracts":{"get":{"tags":["Contracts"],"security":[{"OpenID":["contracts:read"]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string"},"required":false,"name":"userId","in":"query"}],"responses":{"200":{"description":"Retrieve the users contracts","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Contract"}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/contracts/{id}":{"get":{"tags":["Contracts"],"security":[{"OpenID":["contracts:read"]}],"parameters":[{"schema":{"type":"string","example":"1d78271264b9c76d5842911dd70b4353"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Retrieve the users contracts","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Contract"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/contracts/{id}/licenses":{"get":{"tags":["Contracts"],"security":[{"OpenID":["contracts:read"]}],"parameters":[{"schema":{"type":"string","example":"1d78271264b9c76d5842911dd70b4353"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Retrieve users with license entitlements for the contract","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string","description":"User ID","example":"auth0|123456"},"email":{"type":"string","description":"User email address","example":"user@example.com"},"fullName":{"type":"string","description":"User full name","example":"John Doe"},"sku":{"type":"string","description":"Product SKU","example":"premium-subscription"},"status":{"type":"string","description":"Entitlement status","example":"ACTIVE"},"entitlementId":{"type":"string","description":"Entitlement ID","example":"ent_123456"}},"required":["userId","sku","status","entitlementId"]}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/transactions":{"get":{"tags":["Transactions"],"security":[{"OpenID":["transactions:read"]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string"},"required":false,"name":"transactionId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"billId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"contractId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"userId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"dateFrom","in":"query"},{"schema":{"type":"string"},"required":false,"name":"dateTo","in":"query"},{"schema":{"type":"string"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"from","in":"query"}],"responses":{"200":{"description":"A list of transactions","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Transaction"}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/products":{"get":{"tags":["Products"],"security":[{"OpenID":["products:read"]}],"parameters":[{"schema":{"type":"string"},"required":false,"name":"q","in":"query"}],"responses":{"200":{"description":"Retrieve a list of products","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"post":{"tags":["Products"],"security":[{"OpenID":["products:write"]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["podcast"]},"url":{"type":"string"},"spotifyId":{"type":"string"}},"required":["type","url"]}}}},"responses":{"200":{"description":"A created product","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/products/{sku}":{"get":{"tags":["Products"],"security":[{"OpenID":["products:read"]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"sku","in":"path"}],"responses":{"200":{"description":"Retrieve a a product by SKU","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"patch":{"tags":["Products"],"security":[{"OpenID":["products:write"]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"sku","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"externalIds":{"type":"object","properties":{"spotifyId":{"type":"string"}}},"language":{"type":"string","nullable":true}}}}}},"responses":{"200":{"description":"A created product","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/products/{sku}/fulfillments":{"get":{"tags":["Products"],"security":[{"OpenID":["products:read"]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"sku","in":"path"}],"responses":{"200":{"description":"Retrieve a a product by SKU","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Fulfillment"}}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/users":{"get":{"tags":["Users"],"summary":"List users","description":"Returns a list of users with optional filtering.","security":[{"OpenID":["users:read"]}],"parameters":[{"schema":{"type":"string","description":"Search query","example":"john"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","description":"Number of results to return","example":"10"},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","description":"Offset for pagination","example":"0"},"required":false,"name":"from","in":"query"}],"responses":{"200":{"description":"A list of users matching the query parameters","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Profile"}},"example":[{"userId":"user123","email":"john.doe@example.com","picture":"https://example.com/profile.jpg","name":"John Doe","mobilePhone":"+1234567890","billingAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"deliveryAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"createdAt":"2023-01-01T12:00:00Z","updatedAt":"2023-03-15T09:30:00Z"}]}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"post":{"tags":["Users"],"summary":"Create a user","description":"Creates a new user with the specified email and optional name.","security":[{"OpenID":["users:write"]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email address of the user","example":"new.user@example.com"},"firstName":{"type":"string","description":"First name of the user","example":"New"},"lastName":{"type":"string","description":"Last name of the user","example":"User"}},"required":["email"]},"example":{"email":"new.user@example.com","firstName":"New","lastName":"User"}}}},"responses":{"201":{"description":"User created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/users/{user_id}":{"get":{"tags":["Users"],"summary":"Get a user by ID","description":"Retrieves a specific user's profile by their ID.","security":[{"OpenID":["users:read"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"}],"responses":{"200":{"description":"The requested user profile","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"},"example":{"userId":"user123","email":"john.doe@example.com","picture":"https://example.com/profile.jpg","name":"John Doe","mobilePhone":"+1234567890","billingAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"deliveryAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"createdAt":"2023-01-01T12:00:00Z","updatedAt":"2023-03-15T09:30:00Z"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"patch":{"tags":["Users"],"summary":"Update a user","description":"Updates a specific user's profile with the provided data.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","nullable":true,"description":"First name of the user","example":"John"},"lastName":{"type":"string","nullable":true,"description":"Last name of the user","example":"Doe"},"nickname":{"type":"string","nullable":true,"description":"Nickname of the user","example":"Johnny"},"mobilePhone":{"type":"string","nullable":true,"description":"Mobile phone number","example":"+1234567890"},"workPhone":{"type":"string","nullable":true,"description":"Work phone number","example":"+1234567891"},"homePhone":{"type":"string","nullable":true,"description":"Home phone number","example":"+1234567892"},"billingAddress":{"type":"object","nullable":true,"properties":{"country":{"type":"string","minLength":2,"maxLength":2},"zip":{"type":"string"},"city":{"type":"string"},"street":{"type":"string"},"co":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"}},"description":"Billing address information"},"deliveryAddress":{"type":"object","nullable":true,"properties":{"country":{"type":"string","minLength":2,"maxLength":2},"zip":{"type":"string"},"city":{"type":"string"},"street":{"type":"string"},"co":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"}},"description":"Delivery address information"},"user_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"nullable":true},{"nullable":true}]},"description":"User metadata key-value pairs. Set a value to null to delete that key."},"given_name":{"type":"string","description":"Deprecated: Use firstName instead","deprecated":true},"family_name":{"type":"string","description":"Deprecated: Use lastName instead","deprecated":true},"phone_number":{"type":"string","nullable":true,"description":"Deprecated: Use mobilePhone instead","deprecated":true}}},"example":{"firstName":"Jane","lastName":"Smith","nickname":"Janie","mobilePhone":"+9876543210","billingAddress":{"country":"NO","zip":"0150","city":"Oslo","street":"New Street 456"}}}}},"responses":{"200":{"description":"The updated user profile","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"},"example":{"userId":"user123","email":"john.doe@example.com","picture":"https://example.com/profile.jpg","name":"John Doe","mobilePhone":"+1234567890","billingAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"deliveryAddress":{"country":"SE","zip":"12345","city":"Stockholm","street":"Main Street 123","firstName":"John","lastName":"Doe"},"createdAt":"2023-01-01T12:00:00Z","updatedAt":"2023-03-15T09:30:00Z"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"delete":{"tags":["Users"],"summary":"Delete a user","description":"Deletes a user from the auth server. This action is irreversible.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"}],"responses":{"200":{"description":"User deleted successfully","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"409":{"description":"Conflict - User has active entitlements","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Cannot delete user with active entitlements"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/users/{user_id}/change-login-identifier":{"post":{"tags":["Users"],"summary":"Change user login identifier","description":"Changes the email address that a user uses to log in.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"The new email address to use for login","example":"new.email@example.com"}},"required":["email"]},"example":{"email":"new.email@example.com"}}}},"responses":{"200":{"description":"Login identifier changed successfully","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"400":{"description":"Bad request - Email already in use or invalid format","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Email address is already in use"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/users/{user_id}/user_metadata/{key}":{"put":{"tags":["Users"],"summary":"Set user metadata value","description":"Sets a metadata value for a specific user with the specified key.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"},{"schema":{"type":"string","example":"preferences"},"required":true,"description":"The key of the metadata entry","name":"key","in":"path"}],"requestBody":{"content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UserMetadata"},"example":"premium-user"}}},"responses":{"200":{"description":"Metadata value set successfully","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}},"delete":{"tags":["Users"],"summary":"Delete user metadata value","description":"Deletes a metadata value for a specific user with the specified key.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"},{"schema":{"type":"string","example":"preferences"},"required":true,"description":"The key of the metadata entry","name":"key","in":"path"}],"responses":{"200":{"description":"Metadata value deleted successfully","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/users/{user_id}/set-password":{"post":{"tags":["Users"],"summary":"Set user password","description":"Sets or updates the password for a user. Creates a password authentication method if one does not exist.","security":[{"OpenID":["users:write"]}],"parameters":[{"schema":{"type":"string","example":"user123"},"required":true,"description":"The unique identifier of the user","name":"user_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"password":{"type":"string","minLength":6,"description":"The new password for the user","example":"SecurePassword123!"}},"required":["password"]},"example":{"password":"SecurePassword123!"}}}},"responses":{"200":{"description":"Password set successfully","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]},"example":{"success":true}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Unauthorized"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Forbidden"}}}},"404":{"description":"Not Found - The requested resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"example":{"message":"Not Found"}}}},"503":{"description":"Service Unavailable - Failed to connect to upstream service"}}}},"/management/mc/customers/{customerId}":{"get":{"tags":["Compatibility"],"summary":"Get customer information","description":"Returns customer information in XML format for Mediaconnect compatibility.","security":[{"OpenID":["users:read","user:read"],"Basic":["users:read","user:read"]}],"parameters":[{"schema":{"type":"string","example":"958280"},"required":true,"description":"The unique identifier of the customer","name":"customerId","in":"path"}],"responses":{"200":{"description":"Customer information in XML format","headers":{"cache-control":{"schema":{"type":"string"},"required":false},"vary":{"schema":{"type":"string"},"required":false},"Last-Modified":{"schema":{"type":"string"},"required":false},"X-Request-Id":{"schema":{"type":"string"},"required":false}},"content":{"application/xml":{"schema":{"type":"string","description":"Customer information in XML format","example":"\n