---
title: REST API endpoints for enterprise users
shortTitle: Users
allowTitleToDifferFromFilename: true
intro: >-
  Use the REST API to suspend{% ifversion ghes %}, unsuspend, promote, and
  demote{% endif %} users on your enterprise.
versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
  ghes: '*'
topics:
  - API
autogenerated: rest
---

## About user administration

These endpoints are only available to [authenticated](/rest/overview/authenticating-to-the-rest-api) site administrators. Normal users will receive a `403` response.

{% data reusables.user-settings.enterprise-admin-api-classic-pat-only %}

<!-- Content after this section is automatically generated -->