Skip to content

Commit 3bd834c

Browse files
committed
Tags object removed from responses
1 parent 6de8923 commit 3bd834c

5 files changed

Lines changed: 13 additions & 34 deletions

File tree

docs/en/api/getUser.md

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -65,16 +65,11 @@ The response body contains the requested user data in JSON format including any
6565
"type": "adobeID",
6666
"groups": [
6767
"_org_admin"
68-
],
69-
"tags": [
70-
"edu_student"
7168
]
7269
}
7370
}
7471
```
7572

76-
:warning: As of October 16, 2025, the `tags` array will no longer be returned.
77-
7873
<a name="getUserGroupsExample" class="api-ref-subtitle">[Enterprise](glossary.md#enterpriseId) User with membership</a> in two user-groups but no administrative roles. If the fields are not populated (`firstname` and`lastname` in this example), they are excluded from the response.
7974
```json
8075
{
@@ -143,16 +138,11 @@ __user:__ A _user_ object containing relevant properties. Properties that are n
143138
"lastname": "string",
144139
"status": "string",
145140
"type": "string",
146-
"username": "string",
147-
"tags": [
148-
"string"
149-
]
141+
"username": "string"
150142
}
151143
}
152144
```
153145

154-
:warning: As of October 16, 2025, the `tags` array will no longer be returned.
155-
156146
{% include_relative partials/badRequest.md anchor="400getUser" %}
157147

158148
{% include_relative partials/unauthorized.md anchor="401getUser" %}

docs/en/api/getUsersByGroup.md

Lines changed: 3 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -79,10 +79,7 @@ A successful request returns a response body with the requested user data in JSO
7979
"username": "john",
8080
"domain": "example.com",
8181
"country": "US",
82-
"type": "federatedID",
83-
"tags": [
84-
"edu_student"
85-
]
82+
"type": "federatedID"
8683
},
8784
{
8885
"email": "jane@example.com",
@@ -119,8 +116,6 @@ A successful request returns a response body with the requested user data in JSO
119116
}
120117
```
121118

122-
:warning: As of October 16, 2025, the `tags` array will no longer be returned.
123-
124119
<a name="getUsersWithNoGroupsExample" class="api-ref-subtitle">Response returning three members of the Document Cloud 1 group. The `groups` array for each user has been excluded in the response as the query parameter `excludeGroups=true` was included:</a>
125120

126121
```json
@@ -135,10 +130,7 @@ A successful request returns a response body with the requested user data in JSO
135130
"username": "john",
136131
"domain": "example.com",
137132
"country": "US",
138-
"type": "federatedID",
139-
"tags": [
140-
"edu_student"
141-
]
133+
"type": "federatedID"
142134
},
143135
{
144136
"email": "jane@example.com",
@@ -161,8 +153,6 @@ A successful request returns a response body with the requested user data in JSO
161153
}
162154
```
163155

164-
:warning: As of October 16, 2025, the `tags` array will no longer be returned.
165-
166156
<a name="getUsersExampleLastPage" class="api-ref-subtitle">Response to request for the last page:
167157

168158
```json
@@ -223,17 +213,12 @@ __users:__ Contains a list of _User_ objects. Properties that are not populated
223213
"lastname": "string",
224214
"status": "string",
225215
"type": "string",
226-
"username": "string",
227-
"tags": [
228-
"string"
229-
]
216+
"username": "string"
230217
}
231218
]
232219
}
233220
```
234221

235-
:warning: As of October 16, 2025, the `tags` array will no longer be returned.
236-
237222
{% include_relative partials/badRequest.md anchor="400getUsersByGroup" %}
238223

239224
{% include_relative partials/unauthorized.md anchor="401getUsersByGroup" %}

docs/en/api/getUsersWithPage.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -72,10 +72,7 @@ A successful request returns a response body with the requested user data in JSO
7272
"username": "psmith",
7373
"domain": "example.com",
7474
"country": "US",
75-
"type": "federatedID",
76-
"tags": [
77-
"edu_student"
78-
]
75+
"type": "federatedID"
7976
},
8077
{
8178
"email": "jane@example.com",

docs/en/api/partials/userSchemaDescription.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,5 +15,4 @@
1515
* "removed": The user account is being removed.
1616
* __type:__ _string_, The user type, one of: `{ "adobeID", "enterpriseID", "federatedID", "unknown" }`. See [Identity Types](glossary.md#identity) for more information.
1717
* __username:__ _string_; The user's username (applicable for [Enterprise](glossary.md#enterpriseId) and [Federated](glossary.md#federatedId) users). For most [Adobe ID](glossary.md#adobeId) users, this value is the same as the email address.
18-
* __tags:__ _string[]_; Returns a list of the tags applied to a user e.g. `["edu_student", "edu_staff"]`. This will not be returned if the user has no tags.
1918
* **adminRoles:** _string[]_; Deprecated. Administrative roles are reflected in group memberships, returned in the `groups` field.

docs/en/index.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,14 @@ Welcome to the documentation center for User Management APIs from Adobe.
1111

1212
<h2>News</h2>
1313
<div class="isa_info">
14+
<p><strong>October 27, 2025</strong>: As previously notified, UMAPI no longer returns "tags" information for the following APIs:</p>
15+
<ul>
16+
<li><a href="api/getUser.html">Get User Information</a></li>
17+
<li><a href="api/getUsersWithPage.html">Get Users in Organization</a></li>
18+
<li><a href="api/getUsersByGroup.html">Get Users by Group</a></li>
19+
</ul>
20+
<p>All references to this field have been removed from the relevant documentation.</p>
21+
<hr class="api-ref-rule">
1422
<p><strong>July 23, 2025</strong>: We've been made aware that some customers are receiving group names with a mysterious suffix, such as <code>provisioning</code>. Since these groups or profiles with these names don't exist in Admin Console (they were a historic construct from a previous iteration of the Adobe platform), we will ensure that we fully filter out these mystery group names. APIs that return lists of group names will be changed to return <strong>only</strong> user group and product profile names that really exist in the org.</p>
1523
<p>As a best practice, it is recommended to avoid any logic that expects fixed names.</p>
1624
<p>This change will come into effect on <em><strong><s>August 26</s> <s>September 23, 2025</s> October 28, 2025</strong></em>.</p>

0 commit comments

Comments
 (0)