Merge pull request #105 from adobe-apiplatform/unknown-status

Include information on forcing user type field to unknown

Author: adobeDavidT

docs/en/api/getUser.md

@@ -30,6 +30,7 @@ __Throttle Limits__: Maximum 25 requests per minute per a client. See [Throttlin
 | domain | query | false | Optional parameter but highly recommended including for all user types. For [AdobeID](glossary.html#adobeId) users this would be `AdobeID`. For [Enterprise](glossary.html#enterpriseId) and _[email-federated](glossary.html#federatedId)_ users the domain will either match the email domain or, in the case of multi-domain federations, have any other domain for that directory. |
 | content-type | header | false | {% include_relative partials/contentTypeDescription.md %} |
 | X-Request-Id | header | false | {% include_relative partials/requestIdDescription.md %} |
+| X-UMAPI-Usertype-Unknown | header | false | Set this to `true` if you need the `type` field to return `unknown` |
 {:.bordertablestyle}
 
 ## <a name="responses" class="api-ref-subtitle">Responses</a>

docs/en/api/getUsersByGroup.md

@@ -37,6 +37,7 @@ __Throttle Limits__: Maximum 25 requests per minute per a client. See [Throttlin
 | directOnly | query | false | {% include_relative partials/directOnlyDescription.md %} |
 | status | query | false | For product profiles only, return only active or inactive members. Pass `active` to list users that have been provisioned for the product and have an active license. Pass `inactive` to list users who have been added to the product profile but do not have an _active_ license. When not provided, lists all member users regardless of their entitlement status.|
 | excludeGroups | query | false | Default value is `false`. When `true` is passed the response will exclude the `groups` array from being returned for each individual user. See [example](#getUsersWithNoGroupsExample). |
+| X-UMAPI-Usertype-Unknown | header | false | Set this to `true` if you need the user `type` field to return `unknown` |
 {:.bordertablestyle}
 
 ## <a name="responses" class="api-ref-subtitle">Responses</a>

docs/en/api/getUsersWithPage.md

@@ -34,6 +34,7 @@ __Throttle Limits__: Maximum 25 requests per minute per a client. See [Throttlin
 | X-Request-Id | header | false | {% include_relative partials/requestIdDescription.md %} |
 | domain | query | false | Retrieves users from a domain linked to an organization through the Trusted Domain relationship. |
 | directOnly | query | false | {% include_relative partials/directOnlyDescription.md %} |
+| X-UMAPI-Usertype-Unknown | header | false | Set this to `true` if you need the user `type` field to return `unknown` |
 {:.bordertablestyle}
 
 ## <a name="responses" class="api-ref-subtitle">Responses</a>

docs/en/index.md

@@ -11,6 +11,8 @@ Welcome to the documentation center for User Management APIs from Adobe.
 
 <h2>News</h2>
 <div class="isa_info">
+<p><strong>Mar 16, 2026</strong>: If you need to resolve a user type to `unknown` rather than one of `Adobe ID`, `Federated ID`, `Enterprise ID`, you can now pass in a header value `X-UMAPI-Usertype-Unknown: true`. This will then ensure that for those users who show as "Not available" can be correctly distinguished, without changing the current expectations of clients.</p>
+<hr class="api-ref-rule">
 <p><strong>Feb 6, 2026</strong>: The fix from Feb 3 to correctly resolve user type as `unknown` when the account shows as "Not available" in Admin Console has been reverted due to an issue impacting User Sync Tool customers. A new date for this fix will be announced in the near future.</p>
 <hr class="api-ref-rule">
 <p><strong>Feb 3, 2026</strong>: Deployment scheduled to fix the wrong identity type showing for impacted Business IDs that lost their auth account through permanent removal in the main (domain owning) Organisation. The previous type was showing "adobeID" and now it shows "unknown".