openapi: 3.0.1
info:
title: Meraki Dashboard API — administered
description: 'A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.
> Date: 05 August, 2026
>
> [Recent Updates](https://meraki.io/whats-new/)
---
[API Documentation](https://meraki.io/api)
[Community Support](https://meraki.io/community)
[Meraki Homepage](https://www.meraki.com)
'
contact:
name: Meraki Developer Community
url: https://meraki.io/community
version: 1.73.0
x-provenance:
method: harvested
authored_by: Cisco Meraki
harvested_by: API Evangelist
harvested_on: '2026-08-19'
first_party: true
note: Published by Cisco. Retrieved unmodified except for this x-provenance block.
provider_published: true
derived_view: Per-first-tag view of the source document, tag 'administered'. Operations and schemas are the provider's,
unmodified.
x-evidence:
- type: source
url: https://github.com/meraki/openapi/blob/master/openapi/spec3.json
- type: raw
url: https://raw.githubusercontent.com/meraki/openapi/master/openapi/spec3.json
- type: alternate
url: https://api.meraki.com/api/v1/openapiSpec
servers:
- url: https://api.meraki.com/{basePath}
variables:
basePath:
default: api/v1
security:
- meraki_api_key: []
- bearerAuth: []
tags:
- name: administered
paths:
/administered/identities/me:
get:
description: Returns the identity of the current user.
operationId: getAdministeredIdentitiesMe
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: Username
email:
type: string
description: User email
lastUsedDashboardAt:
type: string
format: date-time
description: Last seen active on Dashboard UI
authentication:
type: object
properties:
mode:
type: string
description: Authentication mode
api:
type: object
properties:
key:
type: object
properties:
created:
type: boolean
description: If API key is created for this user
description: API key
description: API authentication
twoFactor:
type: object
properties:
enabled:
type: boolean
description: If twoFactor authentication is enabled for this user
description: TwoFactor authentication
saml:
type: object
properties:
enabled:
type: boolean
description: If SAML authentication is enabled for this user
description: SAML authentication
description: Authentication info
example:
name: Miles Meraki
email: miles@meraki.com
lastUsedDashboardAt: '2018-02-11T00:00:00.090210Z'
authentication:
mode: email
api:
key:
created: true
twoFactor:
enabled: false
saml:
enabled: false
summary: Returns the identity of the current user.
tags:
- administered
- monitor
- identities
- me
/administered/identities/me/api/keys:
get:
description: List the non-sensitive metadata associated with the API keys that belong to the user
operationId: getAdministeredIdentitiesMeApiKeys
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: array
items:
type: object
properties:
suffix:
type: string
description: Last 4 characters of the API key
createdAt:
type: string
description: Date that the API key was created
example:
- suffix: da4f
createdAt: '2018-02-11T00:00:00.090210Z'
summary: List the non-sensitive metadata associated with the API keys that belong to the user
tags:
- administered
- configure
- identities
- me
- api
- keys
/administered/identities/me/api/keys/generate:
post:
description: Generates an API key for an identity. For users who have access to more than one organization, the change
will take up to five minutes to propagate. If one of the organizations is currently under maintenance, the change
may not propagate fully until after the maintenance has been completed.
operationId: generateAdministeredIdentitiesMeApiKeys
responses:
'202':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
key:
type: string
description: API key in plaintext. This value will not be accessible outside of key generation
example:
key: '1284392014819'
summary: Generates an API key for an identity
tags:
- administered
- configure
- identities
- me
- api
- keys
/administered/identities/me/api/keys/{suffix}/revoke:
post:
description: Revokes an identity's API key, using the last four characters of the key. For users who have access to
more than one organization, the change will take up to five minutes to propagate. If one of the organizations is currently
under maintenance, the change may not propagate fully until after the maintenance has been completed.
operationId: revokeAdministeredIdentitiesMeApiKeys
parameters:
- name: suffix
in: path
description: Suffix
schema:
type: string
required: true
responses:
'202':
description: Successful operation
summary: Revokes an identity's API key, using the last four characters of the key
tags:
- administered
- configure
- identities
- me
- api
- keys