Google Admin SDK Admin API
The Admin API from Google Admin SDK — 11 operation(s) for admin.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/google-admin-sdk-admin-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Google SDK Directory Admin API
description: The Admin SDK Directory API enables management of users, groups, devices, organizational units, roles, domains, and other directory resources in a Google Workspace domain.
version: directory_v1
contact:
name: Google
url: https://developers.google.com/workspace/admin/directory/reference/rest
servers:
- url: https://admin.googleapis.com
tags:
- name: Admin
paths:
/admin/directory/v1/users:
get:
operationId: listUsers
summary: Google Admin SDK List users
description: Retrieves a paginated list of either deleted users or all users in a domain.
parameters:
- name: domain
in: query
schema:
type: string
- name: customer
in: query
schema:
type: string
- name: maxResults
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
- name: query
in: query
schema:
type: string
- name: orderBy
in: query
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Users'
tags:
- Admin
post:
operationId: createUser
summary: Google Admin SDK Create user
description: Creates a user.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/User'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/User'
tags:
- Admin
/admin/directory/v1/users/{userKey}:
get:
operationId: getUser
summary: Google Admin SDK Get user
description: Retrieves a user.
parameters:
- name: userKey
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/User'
tags:
- Admin
put:
operationId: updateUser
summary: Google Admin SDK Update user
description: Updates a user.
parameters:
- name: userKey
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/User'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/User'
tags:
- Admin
patch:
operationId: patchUser
summary: Google Admin SDK Patch user
description: Patches a user.
parameters:
- name: userKey
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/User'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/User'
tags:
- Admin
delete:
operationId: deleteUser
summary: Google Admin SDK Delete user
description: Deletes a user.
parameters:
- name: userKey
in: path
required: true
schema:
type: string
responses:
'204':
description: Successful deletion
tags:
- Admin
/admin/directory/v1/users/{userKey}/makeAdmin:
post:
operationId: makeUserAdmin
summary: Google Admin SDK Make user admin
description: Makes a user a super administrator.
parameters:
- name: userKey
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
status:
type: boolean
responses:
'204':
description: Successful response
tags:
- Admin
/admin/directory/v1/groups:
get:
operationId: listGroups
summary: Google Admin SDK List groups
description: Retrieves all groups of a domain or a user.
parameters:
- name: domain
in: query
schema:
type: string
- name: customer
in: query
schema:
type: string
- name: maxResults
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
- name: userKey
in: query
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Groups'
tags:
- Admin
post:
operationId: createGroup
summary: Google Admin SDK Create group
description: Creates a group.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
tags:
- Admin
/admin/directory/v1/groups/{groupKey}:
get:
operationId: getGroup
summary: Google Admin SDK Get group
description: Retrieves a group's properties.
parameters:
- name: groupKey
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
tags:
- Admin
put:
operationId: updateGroup
summary: Google Admin SDK Update group
description: Updates a group's properties.
parameters:
- name: groupKey
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Group'
tags:
- Admin
delete:
operationId: deleteGroup
summary: Google Admin SDK Delete group
description: Deletes a group.
parameters:
- name: groupKey
in: path
required: true
schema:
type: string
responses:
'204':
description: Successful deletion
tags:
- Admin
/admin/directory/v1/groups/{groupKey}/members:
get:
operationId: listMembers
summary: Google Admin SDK List group members
description: Retrieves a paginated list of all members in a group.
parameters:
- name: groupKey
in: path
required: true
schema:
type: string
- name: maxResults
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Members'
tags:
- Admin
post:
operationId: addMember
summary: Google Admin SDK Add group member
description: Adds a user to the specified group.
parameters:
- name: groupKey
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Member'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Member'
tags:
- Admin
/admin/directory/v1/customer/{customerId}/orgunits:
get:
operationId: listOrgUnits
summary: Google Admin SDK List organizational units
description: Retrieves a list of all organizational units for an account.
parameters:
- name: customerId
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/OrgUnits'
tags:
- Admin
post:
operationId: createOrgUnit
summary: Google Admin SDK Create organizational unit
description: Adds an organizational unit.
parameters:
- name: customerId
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrgUnit'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/OrgUnit'
tags:
- Admin
/admin/directory/v1/customer/{customerId}/devices/chromeos:
get:
operationId: listChromeOsDevices
summary: Google Admin SDK List Chrome OS devices
description: Retrieves a paginated list of Chrome OS devices.
parameters:
- name: customerId
in: path
required: true
schema:
type: string
- name: maxResults
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ChromeOsDevices'
tags:
- Admin
/admin/directory/v1/customer/{customerId}/devices/mobile:
get:
operationId: listMobileDevices
summary: Google Admin SDK List mobile devices
description: Retrieves a paginated list of all user-owned mobile devices.
parameters:
- name: customerId
in: path
required: true
schema:
type: string
- name: maxResults
in: query
schema:
type: integer
- name: pageToken
in: query
schema:
type: string
responses:
'200':
description: Successful response
tags:
- Admin
/admin/directory/v1/customer/{customerId}/roles:
get:
operationId: listRoles
summary: Google Admin SDK List roles
description: Retrieves a paginated list of all the roles in a domain.
parameters:
- name: customerId
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
tags:
- Admin
/admin/directory/v1/customer/{customer}/domains:
get:
operationId: listDomains
summary: Google Admin SDK List domains
description: Lists the domains of the customer.
parameters:
- name: customer
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
tags:
- Admin
components:
schemas:
Users:
type: object
properties:
kind:
type: string
users:
type: array
items:
$ref: '#/components/schemas/User'
nextPageToken:
type: string
Member:
type: object
properties:
kind:
type: string
id:
type: string
email:
type: string
role:
type: string
enum:
- MEMBER
- MANAGER
- OWNER
type:
type: string
enum:
- USER
- GROUP
- EXTERNAL
User:
type: object
properties:
kind:
type: string
id:
type: string
primaryEmail:
type: string
name:
type: object
properties:
givenName:
type: string
familyName:
type: string
fullName:
type: string
isAdmin:
type: boolean
isDelegatedAdmin:
type: boolean
suspended:
type: boolean
orgUnitPath:
type: string
creationTime:
type: string
format: date-time
lastLoginTime:
type: string
format: date-time
password:
type: string
Groups:
type: object
properties:
kind:
type: string
groups:
type: array
items:
$ref: '#/components/schemas/Group'
nextPageToken:
type: string
Group:
type: object
properties:
kind:
type: string
id:
type: string
email:
type: string
name:
type: string
description:
type: string
directMembersCount:
type: string
ChromeOsDevices:
type: object
properties:
kind:
type: string
chromeosdevices:
type: array
items:
type: object
nextPageToken:
type: string
OrgUnit:
type: object
properties:
kind:
type: string
orgUnitId:
type: string
name:
type: string
description:
type: string
orgUnitPath:
type: string
parentOrgUnitPath:
type: string
parentOrgUnitId:
type: string
Members:
type: object
properties:
kind:
type: string
members:
type: array
items:
$ref: '#/components/schemas/Member'
nextPageToken:
type: string
OrgUnits:
type: object
properties:
kind:
type: string
organizationUnits:
type: array
items:
$ref: '#/components/schemas/OrgUnit'