Users changedapi/beta/organization/users
Nearest release: v2.1.322, published 2 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+267added
Lines−0removed
From line
401
where the diff opens
First seen
26 Aug 2026
this site's first read of the page
Recorded edits9to this page, all time
## Sign Out User ### Beta Cannot Sign Out Managed Member Error Details ### Beta Cannot Sign Out Membership Admin Error Details ### Beta Cannot Sign Out Owner Error Details ### Beta Cannot Sign Out Primary Owner Error Details ### Beta Cannot Sign Out Privileged Member Error Details ### Beta Cannot Sign Out Self Error Details
The whole hunk
from line 401, old and new numbered
/
from line 401
401401}
402402```
403403
404## Sign Out User
405
406**POST** `/v1/organizations/users/{user_id}/sign_out`
407
408Sign a member out of Claude everywhere, without removing them from the organization. This ends their sign-in sessions and removes their trusted devices wherever they use Claude, including other organizations and individual plans. It also ends the OAuth tokens issued to them for this organization, so apps such as Claude Code must sign in again.
409
410A token can take up to an hour to stop working, though it almost always stops at once. The member keeps their role and can sign in again right away. To keep them out, remove them from the organization or, if your organization uses single sign-on, block them in your identity provider. Signing out does not end API keys, OAuth tokens that were not issued for this organization, or the member's Claude Code cloud sessions and routines.
411
412You cannot sign out the organization's primary owner or the person your API key or token acts for, and a request to sign out another owner, a member with owner permissions, or a membership admin may be refused. A refused request returns a `400` or `403` error that says why. If the request returns `503`, send it again to finish; anything already ended stays ended.
413
414Every request must include the beta header `anthropic-beta: admin-user-sign-out-2026-10-08`. A request without it returns `400`. Sign-out is in beta for Claude Enterprise organizations. In an organization where it is not enabled, a request returns `400` with `error_code` `organization_not_enrolled_in_beta`. In a Claude Enterprise organization, an API key needs the `write:members` scope; a key without it gets `403`.
415
416### Path parameters
417
418- `user_id: string`
419
420 ID of the User.
421
422### Headers
423
424- `"anthropic-version": optional string`
425
426 The version of the Claude API you want to use.
427
428 Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http).
429
430- `"anthropic-beta": array of AnthropicBeta`
431
432 This endpoint is in beta: requests must send `admin-user-sign-out-2026-10-08` in this header.
433
434 - `string`
435
436 - `"message-batches-2024-09-24"`
437
438 - `"prompt-caching-2024-07-31"`
439
440 - `"computer-use-2024-10-22"`
441
442 - `"computer-use-2025-01-24"`
443
444 - `"pdfs-2024-09-25"`
445
446 - `"token-counting-2024-11-01"`
447
448 - `"token-efficient-tools-2025-02-19"`
449
450 - `"output-128k-2025-02-19"`
451
452 - `"files-api-2025-04-14"`
453
454 - `"mcp-client-2025-04-04"`
455
456 - `"mcp-client-2025-11-20"`
457
458 - `"dev-full-thinking-2025-05-14"`
459
460 - `"interleaved-thinking-2025-05-14"`
461
462 - `"code-execution-2025-05-22"`
463
464 - `"extended-cache-ttl-2025-04-11"`
465
466 - `"context-1m-2025-08-07"`
467
468 - `"context-management-2025-06-27"`
469
470 - `"model-context-window-exceeded-2025-08-26"`
471
472 - `"skills-2025-10-02"`
473
474 - `"fast-mode-2026-02-01"`
475
476 - `"output-300k-2026-03-24"`
477
478 - `"user-profiles-2026-03-24"`
479
480 - `"user-profiles-2026-08-18"`
481
482 - `"user-profiles-2026-09-04"`
483
484 - `"advisor-tool-2026-03-01"`
485
486 - `"managed-agents-2026-04-01"`
487
488 - `"cache-diagnosis-2026-04-07"`
489
490 - `"dreaming-2026-04-21"`
491
492 - `"thinking-token-count-2026-05-13"`
493
494 - `"server-side-fallback-2026-06-01"`
495
496 - `"server-side-fallback-2026-07-01"`
497
498 - `"fallback-credit-2026-06-01"`
499
500 - `"fallback-credit-2026-07-01"`
501
502 - `"agent-memory-2026-07-22"`
503
504 - `"mid-conversation-tool-changes-2026-07-01"`
505
506 - `"compact-2026-01-12"`
507
508 - `"computer-use-2025-11-24"`
509
510 - `"mcp-tunnels-2026-06-22"`
511
512 - `"structured-outputs-2025-11-13"`
513
514 - `"task-budgets-2026-03-13"`
515
516 - `"thinking-display-updates-2026-08-18"`
517
518 - `"ce-user-management-2026-07-13"`
519
520 - `"mid-conversation-output-config-2026-07-01"`
521
522 - `"thinking-binding-controls-2026-08-01"`
523
524 - `"mid-conversation-system-clear-at-2026-08-21"`
525
526 - `"compact-2026-09-04"`
527
528 - `"inline-tools-2026-09-15"`
529
530 - `"mcp-client-2026-09-15"`
531
532 - `"ce-plugins-2026-09-01"`
533
534 - `"spend-limit-reads-2026-09-26"`
535
536 - `"telemetry-destinations-2026-08-11"`
537
538 - `"webhooks-2026-10-07"`
539
540 - `"admin-user-sign-out-2026-10-08"`
541
542 - `"message-threads-2026-08-12"`
543
544 - `"analytics-usage-cost-2026-08-24"`
545
546 - `"experimental-claude-tag-2026-10-21"`
547
548### Returns
549
550- `BetaOrganizationUser object`
551
552 - `type: "user"`
553
554 Object type.
555
556 For Users, this is always `"user"`.
557
558 default: user
559
560 - `id: string`
561
562 ID of the User.
563
564 - `added_at: string`
565
566 RFC 3339 datetime string indicating when the User joined the Organization.
567
568 format: date-time
569
570 - `email: string`
571
572 Email of the User.
573
574 - `name: string`
575
576 Name of the User.
577
578 - `role: BetaOrganizationRole`
579
580 Organization role of the User.
581
582 - `"admin"`
583
584 - `"billing"`
585
586 - `"claude_code_user"`
587
588 - `"developer"`
589
590 - `"managed"`
591
592 - `"membership_admin"`
593
594 - `"owner"`
595
596 - `"primary_owner"`
597
598 - `"user"`
599
600### Example
601
602```bash
603curl https://api.anthropic.com/v1/organizations/users/$USER_ID/sign_out \
604 -X POST \
605 -H 'anthropic-version: 2026-10-21' \
606 -H 'anthropic-beta: admin-user-sign-out-2026-10-08' \
607 -H "Authorization: Bearer $ANTHROPIC_API_KEY"
608```
609
610#### Response (200)
611
612```json
613{
614 "id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
615 "added_at": "2024-10-30T23:58:27.427722Z",
616 "email": "[email protected]",
617 "name": "Jane Doe",
618 "role": "admin",
619 "type": "user"
620}
621```
622
404623## Domain types
624
625### Beta Cannot Sign Out Managed Member Error Details
626
627- `BetaCannotSignOutManagedMemberErrorDetails object`
628
629 The member has the `managed` role, and this API key or token cannot sign them out. The error message says which keys and tokens can.
630
631 - `error_code: "cannot_sign_out_managed_member"`
632
633### Beta Cannot Sign Out Membership Admin Error Details
634
635- `BetaCannotSignOutMembershipAdminErrorDetails object`
636
637 The member is a membership admin, and the person the API key or token belongs to is not allowed to sign out membership admins.
638
639 - `error_code: "cannot_sign_out_membership_admin"`
640
641### Beta Cannot Sign Out Owner Error Details
642
643- `BetaCannotSignOutOwnerErrorDetails object`
644
645 The member is an owner or has owner permissions, and this API key or token cannot sign them out. In a Claude Enterprise organization, an API key with the `write:members` scope can.
646
647 - `error_code: "cannot_sign_out_owner"`
648
649### Beta Cannot Sign Out Primary Owner Error Details
650
651- `BetaCannotSignOutPrimaryOwnerErrorDetails object`
652
653 The member is the organization's primary owner, whom no API key or token can sign out.
654
655 - `error_code: "cannot_sign_out_primary_owner"`
656
657### Beta Cannot Sign Out Privileged Member Error Details
658
659- `BetaCannotSignOutPrivilegedMemberErrorDetails object`
660
661 This OAuth token cannot sign out a membership admin or a member whose roles grant owner, user management, or identity and access management.
662
663 - `error_code: "cannot_sign_out_privileged_member"`
664
665### Beta Cannot Sign Out Self Error Details
666
667- `BetaCannotSignOutSelfErrorDetails object`
668
669 The member is the user the API key or token belongs to.
670
671 - `error_code: "cannot_sign_out_self"`
405672
406673### Beta Organization User
407674
No line in this hunk matches that.