> ## Documentation Index
> Fetch the complete documentation index at: https://developers.notion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke a managed user's sessions

> Revoke a managed user's sessions.

The organization bot token must have the following scopes:

* `managed-user-session:write`


## OpenAPI

````yaml openapi-adminApi.json POST /v1/managed_users/revoke_session
openapi: 3.1.0
info:
  title: Notion Admin API
  version: 1.0.0
  termsOfService: >-
    https://notion.notion.site/Terms-and-Privacy-28ffdd083dc3473e9c2da6ec011b58ac
servers:
  - url: https://api.notion.com/admin
security:
  - bearerAuth: []
tags:
  - name: Exports
    description: Workspace export endpoints
  - name: Legal holds
    description: Legal hold endpoints
  - name: Managed users
    description: Managed user endpoints
paths:
  /v1/managed_users/revoke_session:
    post:
      tags:
        - Managed users
      summary: Revoke a managed user's sessions
      operationId: revoke-user-session
      parameters:
        - $ref: '#/components/parameters/notionVersion'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                user:
                  oneOf:
                    - type: object
                      properties:
                        type:
                          type: string
                          const: email
                          description: Always `email`
                        email:
                          type: string
                          description: The managed user's primary email address.
                      additionalProperties: false
                      required:
                        - type
                        - email
                    - type: object
                      properties:
                        type:
                          type: string
                          const: id
                          description: Always `id`
                        id:
                          type: string
                          description: The managed user's Notion user UUID.
                      additionalProperties: false
                      required:
                        - type
                        - id
                  description: The managed user whose active sessions should be revoked.
              required:
                - user
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    const: revoked
                    description: Confirms that the user's active sessions were revoked.
                required:
                  - status
        '400':
          $ref: '#/components/responses/adminApiError400'
        '401':
          $ref: '#/components/responses/adminApiError401'
        '403':
          $ref: '#/components/responses/adminApiError403'
        '404':
          $ref: '#/components/responses/adminApiError404'
        '429':
          $ref: '#/components/responses/adminApiError429'
        '500':
          $ref: '#/components/responses/adminApiError500'
components:
  parameters:
    notionVersion:
      name: Notion-Version
      in: header
      required: true
      schema:
        enum:
          - '2026-06-01'
      description: The Admin API version to use for this request.
  responses:
    adminApiError400:
      description: The request body, path parameters, or query parameters are invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError400'
          example:
            type: error
            code: validation_error
            status: 400
            message: The request body is invalid.
    adminApiError401:
      description: The request is missing a valid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError401'
          example:
            type: error
            code: unauthorized
            status: 401
            message: Unauthorized.
    adminApiError403:
      description: >-
        The authenticated bot does not have access to the requested resource or
        scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError403'
          example:
            type: error
            code: forbidden
            status: 403
            message: Forbidden.
    adminApiError404:
      description: The requested resource could not be found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError404'
          example:
            type: error
            code: not_found
            status: 404
            message: Not found.
    adminApiError429:
      description: The request was rate limited.
      headers:
        retry-after:
          description: Seconds to wait before retrying the request.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError429'
          example:
            type: error
            code: rate_limited
            status: 429
            message: Rate limited.
    adminApiError500:
      description: An unexpected server error occurred.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/adminApiError500'
          example:
            type: error
            code: internal_server_error
            status: 500
            message: An unexpected error occurred.
  schemas:
    adminApiError400:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - validation_error
        status:
          enum:
            - 400
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
    adminApiError401:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - unauthorized
        status:
          enum:
            - 401
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
    adminApiError403:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - missing_scope
            - forbidden
        status:
          enum:
            - 403
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
    adminApiError404:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - not_found
        status:
          enum:
            - 404
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
    adminApiError429:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - rate_limited
        status:
          enum:
            - 429
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
    adminApiError500:
      type: object
      properties:
        type:
          enum:
            - error
        code:
          enum:
            - internal_server_error
        status:
          enum:
            - 500
        message:
          type: string
      required:
        - type
        - code
        - status
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````