Organizations changedapi/compliance/organizations
Nearest release: v2.1.304, published 6 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+117added
Lines−0removed
From line
227
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits17to this page, all time
## Organizations › User Preferences ### List organization members' personal preferences
The whole hunk
from line 227, old and new numbered
/
from line 227
227227}
228228```
229229
230## Organizations › User Preferences
231
232### List organization members' personal preferences
233
234**GET** `/v1/compliance/organizations/{org_uuid}/user_preferences`
235
236List the personal preferences of an organization's current members.
237
238Returns each member's "Instructions for Claude" and Cowork "Global
239instructions" text. Both are account-level settings: the same text is
240returned under every organization the member belongs to. Members are
241listed in the order they joined the organization, oldest first; use
242`limit` and `page` to paginate. A page may hold fewer than `limit`
243rows, or none at all, without being the last page: the server bounds
244the work it does per request. Follow `next_page` until it is `null`.
245
246#### Path parameters
247
248- `org_uuid: string`
249
250 The organization's UUID
251
252#### Query parameters
253
254- `include_unset: optional boolean`
255
256 When true, list every current member, with `null` for each value they have not set. By default only members with at least one value set are listed.
257
258 default: false
259
260- `limit: optional number`
261
262 Maximum results (default: 20, max: 100)
263
264 default: 20, minimum: 1, maximum: 100
265
266- `page: optional string`
267
268 Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
269
270- `user_ids: optional array of string`
271
272 Restrict the list to these users (max 10 per request). An entry that does not name a current member of the organization matches nothing. Omit to list every eligible member. Enumerate IDs via `GET /v1/compliance/organizations/{org_uuid}/users`.
273
274 maxItems: 10
275
276#### Headers
277
278- `"anthropic-version": optional string`
279
280 The version of the Claude API you want to use.
281
282 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
283
284- `"x-api-key": optional string`
285
286#### Returns
287
288- `data: array of object`
289
290 Current organization members in the order they joined the organization, oldest first. By default only members with at least one value set are listed; with `include_unset=true` every member is.
291
292 - `conversation_preferences: string or null`
293
294 The member's "Instructions for Claude" text from their personal settings, with leading and trailing whitespace removed. `null` when the member has never set it or has cleared it.
295
296 - `cowork_global_instructions: string or null`
297
298 The member's "Global instructions" text for Cowork, Claude's desktop agent, with leading and trailing whitespace removed. `null` when the member has never set it or has cleared it.
299
300 - `user: object`
301
302 The organization member.
303
304 - `id: string`
305
306 User identifier
307
308 - `email_address: string`
309
310 User's current email address
311
312- `has_more: boolean`
313
314 Whether there is a further page to request. A page can hold fewer records than `limit`, or none, and still have more: the server bounds the work it does per request.
315
316- `next_page: string or null`
317
318 Token to retrieve the next page. Use this as the 'page' parameter in your next request; `null` on the last page.
319
320#### Example
321
322```bash
323curl https://api.anthropic.com/v1/compliance/organizations/$ORG_UUID/user_preferences \
324 -H 'anthropic-version: 2023-06-01' \
325 -H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
326```
327
328##### Response (200)
329
330```json
331{
332 "data": [
333 {
334 "conversation_preferences": "Always answer in British English.",
335 "cowork_global_instructions": "Prefer short status updates.",
336 "user": {
337 "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
338 "email_address": "[email protected]"
339 }
340 }
341 ],
342 "has_more": true,
343 "next_page": "cGFnZV90b2tlbl9leGFtcGxlXzE3MzQ1Njc4OTA="
344}
345```
346
230347## Organizations › Roles
231348
232349### List Compliance Roles
No line in this hunk matches that.