HERE WeGo User Service

{"openapi":"3.0.1","info":{"title":"HERE WeGo User Service","description":"The HERE WeGo user service manages user entitlements and it provides role-based access control (RBAC) to those entitlements.<br><br><details><summary><b>Error Codes:</b></summary><p>The following common error codes apply to all endpoints.</p><p><b>400 Bad Request</b><ul><li>E400100: Validation errors using Jakarta's ConstraintViolationException.</li><li>E400101: Database constraint violations using Hibernate's ConstraintViolationException.</li><li>E400102: Validation errors for method arguments using Spring's MethodArgumentNotValidException.</li><li>E400103: Errors when a required request header is missing using Spring's MissingRequestHeaderException.</li><li>E400104: Errors when there is a mismatch between expected and actual argument types using Spring's MethodArgumentTypeMismatchException.</li><li>E400105: Returned when an endpoint requires a payload to be passed but none was provided.</li><li>E400106: Invalid update operation. The provided data does not meet the required conditions.</li><li>E400200: Error response from the microservice using a custom ErrorResponseException.</li><li>E400300: Deserialization errors due to mismatched input using Jackson's MismatchedInputException.</li><li>E400301: Deserialization errors due to an invalid format using Jackson's InvalidFormatException.</li><li>E400302: Errors when the HTTP message cannot be read or parsed during conversion in Spring using HttpMessageNotReadableException.</li><li>E400303: Deserialization errors due to unsupported media type being passed as a request body.</li><li>E400400: Exception thrown when user onboarding process fails.</li><li>E400401: Exception thrown when there are too many results encountered.</li><li>E400500: Zuora subscription is invalid.</li><li>E400600: Thrown when the organization lacks a HERE platform realm, which is required to complete the requested operation.</li></ul></p><p><b>401 Unauthorized</b><ul><li>E401100: Exception thrown for 'x-authorization-iam' token authorization failures</li><li>400300: Invalid characters in access token.</li><li>400601: Unsupported token format.</li><li>400600: Expired token.</li><li>401200: Authorization header missing.</li><li>401201: Invalid Authorization header format, expecting Bearer format.</li><li>401303: Wrong token type.</li><li>401701: Access Token no longer valid.</li><li>401600: No account found for given account Id.</li><li>401510: User has expired.</li><li>401500: User is not enabled.</li><li>404660: No app exists with the given Id.</li><li>401311: Requesting client status is not active.</li><li>401202: Malformed OAuth 1.0 header.</li><li>401204: Time stamp is outside the valid period.</li><li>401205: Unsupported value for signature method.</li><li>401206: Unsupported value for oauth_version parameter.</li><li>401207: Nonce already consumed.</li><li>401300: Invalid client credentials / signature mismatch.</li><li>401310: Invalid signature.</li></ul></p><p><b>403 Forbidden</b><ul><li>E403100: Exception thrown when access to a resource or operation is denied.</li></ul></p><p><b>404 Not Found</b><ul><li>E404100: Indicates the absence of an expected entity or result, due to a missing record in the database.</li></ul></p><p><b>410 Gone</b><ul><li>E410100: Subscription has expired and cannot be used.</li></ul></p><p><b>409 Conflict</b><ul><li>E409100: Exception thrown when there are conflicting organization in feature groups.</li></ul></p><p><b>500 Internal Server Error</b><ul><li>E500100: Exception specific to PostgreSQL database operations.</li><li>E500101: Unexpected or exceptional condition occurred.</li><li>E500102: HAPI authentication error.</li><li>E500103: Organization not onboarded.</li><li>E500104: Exception thrown when tenant schema creation fails.</li><li>E500105: Exception thrown when BAM API call fails.</li></ul></p></details>","version":"1.0.4"},"servers":[{"url":"https://api.wego.hereapi.com/user-service","description":"Production environment for WeGo Pro"}],"tags":[{"name":"Feature Groups","description":"Endpoints for managing feature groups"},{"name":"Subscriptions","description":"Endpoints for managing subscriptions"},{"name":"User Tracking","description":"Endpoints for tracking users"}],"paths":{"/subscriptions/{subscriptionId}":{"put":{"tags":["Subscriptions"],"summary":"Update subscription by ID","description":"Endpoint to update an existing subscription's details.","operationId":"updateSubscriptionById","parameters":[{"name":"subscriptionId","in":"path","description":"Unique subscription id of the subscription to update","required":true,"schema":{"type":"string","format":"uuid"},"example":"d5c4d553-8272-4432-9b13-9135abee6d53"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionUpdatePublicRequestDto"},"example":{"zuoraSubscriptionId":"SUBSCRIPTION-f3f51e10-f22d-4df7-9c28-3367854bca66"}}},"required":true},"responses":{"204":{"description":"Subscription updated successfully"},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Zuora Subscription error","correlationId":"2f2afe17-220e-4318-9299-954280d6b04f","code":"E400500","cause":"Zuora subscription 'SUBSCRIPTION-f3f51e10-f22d-4df7-9c28-3367854bca66' is not active","requestId":"REQ-ae47badf-66c2-4944-83f4-106f595cf975"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"a74fee73-f99c-4721-95a9-96e5c2615e63","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"01ae70f6-d756-4352-b219-b7ee4820f184","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"c622ba3c-2b75-446c-a37b-6e871bce3edf","code":"E404100","cause":"Subscription key not found","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]}},"/subscriptions/keys/{subscriptionKey}":{"get":{"tags":["Subscriptions"],"summary":"Get subscription details by subscription key","description":"Endpoint to retrieve subscription details by their unique Subscription Key.","operationId":"getSubscriptionByKey","parameters":[{"name":"subscriptionKey","in":"path","description":"Unique subscription key of the subscription to retrieve","required":true,"schema":{"type":"string"},"example":"SUBSCRIPTION-494ac3c6-3b17-4586-9662-4c7fb189ac7e"}],"responses":{"200":{"description":"Found the subscription","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionDetailsDto"},"example":{"id":"0e3ad78d-0de7-41e4-8391-2b2b4138560b","subscriptionKey":"SUBSCRIPTION-0e3ad78d-0de7-41e4-8391-2b2b4138560b","keyType":"SINGLE_DEVICE","organization":"Here","status":"ACTIVE","featureGroups":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"feature_group_name","description":"Test feature group description","createdAt":"2025-05-15T16:30:12Z","modifiedAt":"2025-05-15T16:40:12Z"}],"expirationTime":"2025-10-30T15:01:09Z"}}}},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"9fbfc01f-bebd-4d67-afa6-cb55129a978a","code":"E400104","cause":"Invalid argument type: subscriptionKey, expected String","requestId":"REQ-3988cb52-bb32-46be-b788-a502feede54e"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"a74fee73-f99c-4721-95a9-96e5c2615e63","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"01ae70f6-d756-4352-b219-b7ee4820f184","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription not found","content":{"application/json":{"example":{"status":404,"title":"Resource not found","correlationId":"2546e826-e2c5-4e47-a149-54561756ccd1","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id d5c4d553-8272-4432-9b13-9135abee6d54","code":"E404100","requestId":"REQ-4b61ab20-7819-422c-98d5-85d8f7eb5722"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]},"put":{"tags":["Subscriptions"],"summary":"Update subscription by Subscription Key","description":"Endpoint to update an existing subscription's details.","operationId":"updateSubscriptionByKey","parameters":[{"name":"subscriptionKey","in":"path","description":"Unique subscription key of the subscription to update","required":true,"schema":{"type":"string"},"example":"d5c4d553-8272-4432-9b13-9135abee6d53"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionUpdatePublicRequestDto"},"example":{"zuoraSubscriptionId":"SUBSCRIPTION-f3f51e10-f22d-4df7-9c28-3367854bca66"}}},"required":true},"responses":{"204":{"description":"Subscription updated successfully"},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Zuora Subscription error","correlationId":"2f2afe17-220e-4318-9299-954280d6b04f","code":"E400500","cause":"Zuora subscription 'SUBSCRIPTION-f3f51e10-f22d-4df7-9c28-3367854bca66' is not active","requestId":"REQ-ae47badf-66c2-4944-83f4-106f595cf975"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"a74fee73-f99c-4721-95a9-96e5c2615e63","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"01ae70f6-d756-4352-b219-b7ee4820f184","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"c622ba3c-2b75-446c-a37b-6e871bce3edf","code":"E404100","cause":"Subscription key not found","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]}},"/subscriptions":{"get":{"tags":["Subscriptions"],"summary":"Get active subscriptions","description":"Endpoint to get a paginated list of active subscriptions for an organization","operationId":"getActiveSubscriptions","parameters":[{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"Active subscriptions retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubscriptionSummaryDto"}},"example":{"content":[{"id":"7a8f9b2c-ef1d-4c5e-96a7-b8c9d0e1f2a3","subscriptionKey":"SUBSCRIPTION-fafc5397-4044-48b8-9ff7-ae2a17c42238","keyType":"SINGLE_DEVICE"},{"id":"0e3ad78d-0de7-41e4-8391-2b2b4138560b","subscriptionKey":"SUBSCRIPTION-0e3ad78d-0de7-41e4-8391-2b2b4138560b","keyType":"SINGLE_DEVICE"}],"totalElements":2,"totalPages":1}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"2f2afe17-220e-4318-9299-954280d6b04f","code":"E400104","cause":"Invalid argument type: size, expected int","requestId":"REQ-ae47badf-66c2-4944-83f4-106f595cf975"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","code":"E500100","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]},"post":{"tags":["Subscriptions"],"summary":"Create new subscription keys","description":"Endpoint to create new subscription keys","operationId":"createSubscriptionKeysPublic","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionCreateRequestDto"},"example":{"keyType":"SINGLE_DEVICE","numKeys":2,"expirationTime":"2024-05-30T23:59:59","featureGroups":[{"name":"Feature Group Name"},{"id":"321e4567-e89b-12d3-a456-426655440123"}]}}},"required":true},"responses":{"201":{"description":"Subscription keys created successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CreatedSubscriptionDto"}},"example":[{"id":"2550e4f5-547d-43ea-adf8-e3d3ff281583","subscriptionKey":"05e7fcb4-33d4-421d-b43c-447ca6c1364b"},{"id":"18a533ed-b2c3-467b-a56a-06e5d2e5a858","subscriptionKey":"82b5debe-969e-4a3a-836f-b416df5a4a6f"}]}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Validation Error","correlationId":"2f2afe17-220e-4318-9299-954280d6b04f","code":"E400102","cause":"numKeys: Number of keys must be between 1 and 100","requestId":"REQ-ae47badf-66c2-4944-83f4-106f595cf975"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"a74fee73-f99c-4721-95a9-96e5c2615e63","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"404":{"description":"Organization not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"c622ba3c-2b75-446c-a37b-6e871bce3edf","code":"E404100","cause":"Result must not be null","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100","requestId":"REQ-38f62707-746f-4071-ad3d-3c06d64785a7"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]}},"/subscriptions/{subscriptionId}/featureGroups/{featureGroupId}":{"post":{"tags":["Subscriptions"],"summary":"Add a feature group to a subscription","description":"Endpoint to add a feature group to a subscription.","operationId":"addFeatureGroupToSubscription","parameters":[{"name":"subscriptionId","in":"path","description":"ID of the subscription to which the feature group will be added","required":true,"schema":{"type":"string","format":"uuid"},"example":"2550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupId","in":"path","description":"ID of the feature group to add","required":true,"schema":{"type":"string","format":"uuid"},"example":"98c2d8a6-4371-4ac7-b712-43ff7349cbd9"}],"responses":{"204":{"description":"Feature group added successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: subscriptionId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription or feature group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E404100","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id 7c02dfe9-f23e-43ae-8300-19da0e631923","requestId":"REQ-f3a065d0-f868-45f5-8159-e72802e5baac"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","requestId":"REQ-42b7bee9-3997-4cf6-b099-9c5c8b1bdbbd","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]},"delete":{"tags":["Subscriptions"],"summary":"Remove a feature group from a subscription","description":"Endpoint to remove a feature group from a subscription.","operationId":"removeFeatureGroupFromSubscription","parameters":[{"name":"subscriptionId","in":"path","description":"ID of the subscription from which the feature group will be removed","required":true,"schema":{"type":"string","format":"uuid"},"example":"2550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupId","in":"path","description":"ID of the feature group to remove","required":true,"schema":{"type":"string","format":"uuid"},"example":"98c2d8a6-4371-4ac7-b712-43ff7349cbd9"}],"responses":{"204":{"description":"Feature group removed successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: subscriptionId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription or feature group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E404100","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id 7c02dfe9-f23e-43ae-8300-19da0e631923","requestId":"REQ-f3a065d0-f868-45f5-8159-e72802e5baac"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","requestId":"REQ-42b7bee9-3997-4cf6-b099-9c5c8b1bdbbd","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]}},"/subscriptions/keys/{subscriptionKey}/featureGroups/{featureGroupId}":{"post":{"tags":["Subscriptions"],"summary":"Add a feature group to a subscription","description":"Endpoint to add a feature group to a subscription.","operationId":"addFeatureGroupToSubscription_1","parameters":[{"name":"subscriptionKey","in":"path","description":"Unique Subscription Key of the subscription to which the feature group will be added","required":true,"schema":{"type":"string"},"example":"SUBSCRIPTION-550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupId","in":"path","description":"ID of the feature group to add","required":true,"schema":{"type":"string","format":"uuid"},"example":"98c2d8a6-4371-4ac7-b712-43ff7349cbd9"}],"responses":{"204":{"description":"Feature group added successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: subscriptionId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription or feature group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E404100","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id 7c02dfe9-f23e-43ae-8300-19da0e631923","requestId":"REQ-f3a065d0-f868-45f5-8159-e72802e5baac"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","requestId":"REQ-42b7bee9-3997-4cf6-b099-9c5c8b1bdbbd","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]},"delete":{"tags":["Subscriptions"],"summary":"Remove a feature group from a subscription","description":"Endpoint to remove a feature group from a subscription.","operationId":"removeFeatureGroupFromSubscription_1","parameters":[{"name":"subscriptionKey","in":"path","description":"Subscription Key of the subscription from which the feature group will be removed","required":true,"schema":{"type":"string"},"example":"SUBSCRIPTION-2550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupId","in":"path","description":"ID of the feature group to remove","required":true,"schema":{"type":"string","format":"uuid"},"example":"98c2d8a6-4371-4ac7-b712-43ff7349cbd9"}],"responses":{"204":{"description":"Feature group removed successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: featureGroupId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription or feature group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E404100","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id 7c02dfe9-f23e-43ae-8300-19da0e631923","requestId":"REQ-f3a065d0-f868-45f5-8159-e72802e5baac"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","requestId":"REQ-42b7bee9-3997-4cf6-b099-9c5c8b1bdbbd","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]}},"/subscriptions/keys/{subscriptionKey}/featureGroups/names/{featureGroupName}":{"post":{"tags":["Subscriptions"],"summary":"Add a feature group to a subscription","description":"Endpoint to add a feature group to a subscription.","operationId":"addFeatureGroupToSubscription_2","parameters":[{"name":"subscriptionKey","in":"path","description":"Unique Subscription Key of the subscription to which the feature group will be added","required":true,"schema":{"type":"string"},"example":"SUBSCRIPTION-2550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupName","in":"path","description":"Unique name of the feature group to add","required":true,"schema":{"type":"string"},"example":"TRUCK_FEATURE_GROUP"}],"responses":{"204":{"description":"Feature group added successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: subscriptionId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin user","requestId":"REQ-e48e44df-6290-43e4-85eb-8f8a8258e1d8"}}}},"404":{"description":"Subscription or feature group not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":404,"title":"Resource not found","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E404100","cause":"Unable to find com.here.wego.userservice.entity.SubscriptionEntity with id 7c02dfe9-f23e-43ae-8300-19da0e631923","requestId":"REQ-f3a065d0-f868-45f5-8159-e72802e5baac"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":500,"title":"Internal Server Error","requestId":"REQ-42b7bee9-3997-4cf6-b099-9c5c8b1bdbbd","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E500100"}}}}},"security":[{"Bearer":[]},{"apiKey":[]}]},"delete":{"tags":["Subscriptions"],"summary":"Remove a feature group from a subscription","description":"Endpoint to remove a feature group from a subscription.","operationId":"removeFeatureGroupFromSubscription_2","parameters":[{"name":"subscriptionKey","in":"path","description":"Subscription Key of the subscription from which the feature group will be removed","required":true,"schema":{"type":"string"},"example":"SUBSCRIPTION-2550e4f5-547d-43ea-adf8-e3d3ff281583"},{"name":"featureGroupName","in":"path","description":"Unique name of the feature group to remove","required":true,"schema":{"type":"string"},"example":"TRUCK_FEATURE_GROUP"}],"responses":{"204":{"description":"Feature group removed successfully"},"400":{"description":"Invalid request body or parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":400,"title":"Invalid argument type","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E400104","cause":"Invalid argument type: subscriptionId, expected UUID","requestId":"REQ-749a88d3-2976-4459-ab99-a81bd94fe6b1"}}}},"401":{"description":"Unauthorized - Invalid authorization token","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/UnauthorizedErrorResponseDto"},{"$ref":"#/components/schemas/ErrorResponseDto"}]},"example":{"status":401,"title":"Unauthorized","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E401100","cause":"Unauthorized - Invalid Credentials","requestId":"REQ-t59f32eg-3181-52t6-13wc-6g7h9179u8c3"}}}},"403":{"description":"Forbidden - Access to the requested resource is forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponseDto"},"example":{"status":403,"title":"Access Denied","correlationId":"414ed0d4-5804-4173-a136-404ffed07c69","code":"E403100","cause":"Not an admin 

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-wego-user-service-v1-openapi.json