Cisco Meraki Organizations API
The organizations API from Cisco Meraki — 170 operation(s) for organizations.
OpenAPI Specification
openapi: 3.0.1
info:
title: Meraki Dashboard API — organizations
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 'organizations'. 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: organizations
paths:
/organizations:
get:
description: List the organizations that the user has privileges on
operationId: getOrganizations
parameters:
- name: perPage
in: query
description: The number of entries per page returned. Acceptable range is 3 - 9000. Default is 9000.
schema:
type: integer
- name: startingAfter
in: query
description: A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but
it is not limited to those. This parameter should not be defined by client applications. The link for the first,
last, prev, or next page in the HTTP Link header should define it.
schema:
type: string
- name: endingBefore
in: query
description: A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it
is not limited to those. This parameter should not be defined by client applications. The link for the first, last,
prev, or next page in the HTTP Link header should define it.
schema:
type: string
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: string
description: Organization ID
name:
type: string
description: Organization name
url:
type: string
description: Organization URL
api:
type: object
properties:
enabled:
type: boolean
description: Enable API access
description: API related settings
licensing:
type: object
properties:
model:
type: string
enum:
- co-term
- per-device
- subscription
description: Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
description: Licensing related settings
cloud:
type: object
properties:
region:
type: object
properties:
name:
type: string
description: Name of region
host:
type: object
properties:
name:
type: string
description: Name of location
description: Where organization data is hosted
description: Region info
description: Data for this organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty. Details may be named 'MSP
ID', 'customer number', 'IP restriction mode for API', or 'IP restriction mode for dashboard',
if the organization admin has configured any.
description: Information about the organization's management system
privacy:
type: object
description: Privacy-related settings for the organization.
example:
- id: '2930418'
name: My organization
url: https://dashboard.meraki.com/o/VjjsAd/manage/organization/overview
api:
enabled: true
licensing:
model: co-term
cloud:
region:
name: North America
host:
name: United States
management:
details:
- name: MSP ID
value: '123456'
headers:
Link:
schema:
type: string
description: A comma-separated list of first, last, prev, and next relative links used for subsequent paginated
requests.
summary: List the organizations that the user has privileges on
tags:
- organizations
- configure
post:
description: Create a new organization
operationId: createOrganization
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The name of the organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty
description: Information about the organization's management system
example:
name: My organization
management:
details:
- name: MSP ID
value: '123456'
required:
- name
required: true
responses:
'201':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Organization ID
name:
type: string
description: Organization name
url:
type: string
description: Organization URL
api:
type: object
properties:
enabled:
type: boolean
description: Enable API access
description: API related settings
licensing:
type: object
properties:
model:
type: string
enum:
- co-term
- per-device
- subscription
description: Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
description: Licensing related settings
cloud:
type: object
properties:
region:
type: object
properties:
name:
type: string
description: Name of region
host:
type: object
properties:
name:
type: string
description: Name of location
description: Where organization data is hosted
description: Region info
description: Data for this organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty. Details may be named 'MSP
ID', 'customer number', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if
the organization admin has configured any.
description: Information about the organization's management system
privacy:
type: object
description: Privacy-related settings for the organization.
example:
id: '2930418'
name: My organization
url: https://dashboard.meraki.com/o/VjjsAd/manage/organization/overview
api:
enabled: true
licensing:
model: co-term
cloud:
region:
name: North America
host:
name: United States
management:
details:
- name: MSP ID
value: '123456'
summary: Create a new organization
tags:
- organizations
- configure
/organizations/{organizationId}:
get:
description: Return an organization
operationId: getOrganization
parameters:
- name: organizationId
in: path
description: Organization ID
schema:
type: string
required: true
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Organization ID
name:
type: string
description: Organization name
url:
type: string
description: Organization URL
api:
type: object
properties:
enabled:
type: boolean
description: Enable API access
description: API related settings
licensing:
type: object
properties:
model:
type: string
enum:
- co-term
- per-device
- subscription
description: Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
description: Licensing related settings
cloud:
type: object
properties:
region:
type: object
properties:
name:
type: string
description: Name of region
host:
type: object
properties:
name:
type: string
description: Name of location
description: Where organization data is hosted
description: Region info
description: Data for this organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty. Details may be named 'MSP
ID', 'customer number', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if
the organization admin has configured any.
description: Information about the organization's management system
privacy:
type: object
description: Privacy-related settings for the organization.
example:
id: '2930418'
name: My organization
url: https://dashboard.meraki.com/o/VjjsAd/manage/organization/overview
api:
enabled: true
licensing:
model: co-term
cloud:
region:
name: North America
host:
name: United States
management:
details:
- name: MSP ID
value: '123456'
security:
- oauth2:
- dashboard:general:config:read
summary: Return an organization
tags:
- organizations
- configure
put:
description: Update an organization
operationId: updateOrganization
parameters:
- name: organizationId
in: path
description: Organization ID
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: The name of the organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty
description: Information about the organization's management system
api:
type: object
properties:
enabled:
type: boolean
description: If true, enable the access to the Cisco Meraki Dashboard API
description: API-specific settings
privacy:
type: object
description: Privacy-related settings for the organization.
example:
name: My organization
management:
details:
- name: MSP ID
value: '123456'
api:
enabled: true
required: false
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Organization ID
name:
type: string
description: Organization name
url:
type: string
description: Organization URL
api:
type: object
properties:
enabled:
type: boolean
description: Enable API access
description: API related settings
licensing:
type: object
properties:
model:
type: string
enum:
- co-term
- per-device
- subscription
description: Organization licensing model. Can be 'co-term', 'per-device', or 'subscription'.
description: Licensing related settings
cloud:
type: object
properties:
region:
type: object
properties:
name:
type: string
description: Name of region
host:
type: object
properties:
name:
type: string
description: Name of location
description: Where organization data is hosted
description: Region info
description: Data for this organization
management:
type: object
properties:
details:
type: array
items:
type: object
properties:
name:
type: string
description: Name of management data
value:
type: string
description: Value of management data
description: Details related to organization management, possibly empty. Details may be named 'MSP
ID', 'customer number', 'IP restriction mode for API', or 'IP restriction mode for dashboard', if
the organization admin has configured any.
description: Information about the organization's management system
privacy:
type: object
description: Privacy-related settings for the organization.
example:
id: '2930418'
name: My organization
url: https://dashboard.meraki.com/o/VjjsAd/manage/organization/overview
api:
enabled: true
licensing:
model: co-term
cloud:
region:
name: North America
host:
name: United States
management:
details:
- name: MSP ID
value: '123456'
security:
- oauth2:
- dashboard:general:config:write
summary: Update an organization
tags:
- organizations
- configure
delete:
description: Delete an organization
operationId: deleteOrganization
parameters:
- name: organizationId
in: path
description: Organization ID
schema:
type: string
required: true
responses:
'204':
description: Successful operation
summary: Delete an organization
tags:
- organizations
- configure
/organizations/{organizationId}/actionBatches:
post:
callbacks:
actionBatch:
'{$request.body#/callback/url}':
post:
requestBody:
required: true
description: Callback payload
content:
application/json:
schema:
type: object
properties:
organization:
type: object
properties:
id:
type: string
name:
type: string
network:
type: object
properties:
id:
type: string
name:
type: string
sentAt:
type: string
callbackId:
type: string
message:
type: object
properties:
id:
type: string
description: ID of the action batch. Can be used to check the status of the action batch at
/organizations/{organizationId}/actionBatches/{actionBatchId}
organizationId:
type: string
description: ID of the organization this action batch belongs to
confirmed:
type: boolean
description: Flag describing whether the action should be previewed before executing or not
synchronous:
type: boolean
description: Flag describing whether actions should run synchronously or asynchronously
status:
type: object
properties:
completed:
type: boolean
description: Flag describing whether all actions in the action batch have completed
failed:
type: boolean
description: Flag describing whether any actions in the action batch failed
errors:
type: array
items:
type: string
description: List of errors encountered when running actions in the action batch
createdResources:
type: array
items:
type: object
properties:
id:
type: string
description: ID of the created resource
uri:
type: string
description: URI, not including base, of the created resource
description: Resources created as a result of this action batch
required:
- createdResources
description: Status of action batch
actions:
type: array
items:
type: object
properties:
resource:
type: string
description: Unique identifier for the resource to be acted on
operation:
type: string
description: The operation to be used by this action
body:
type: object
additionalProperties: true
description: Data provided in the body of the Action. Contents depend on the Action type
required:
- resource
- operation
description: A set of changes made as part of this action (<a href='https://developer.cisco.com/meraki/api/#/rest/guides/action-batches/'>more
details</a>)
required:
- actions
responses:
2XX:
description: Your server return this code if it accepts the callback
description: Create an action batch
operationId: createOrganizationActionBatch
parameters:
- name: organizationId
in: path
description: Organization ID
schema:
type: string
required: true
requestBody:
content:
application/json:
schema:
type: object
properties:
confirmed:
type: boolean
description: Set to true for immediate execution. Set to false if the action should be previewed before
executing. This property cannot be unset once it is true. Defaults to false.
synchronous:
type: boolean
description: Set to true to force the batch to run synchronous. There can be at most 20 actions in synchronous
batch. Defaults to false.
actions:
type: array
items:
type: object
properties:
resource:
type: string
description: Unique identifier for the resource to be acted on
operation:
type: string
description: The operation to be used
body:
type: object
description: The body of the action
default: {}
required:
- resource
- operation
description: A set of changes to make as part of this action (<a href='https://developer.cisco.com/meraki/api/#/rest/guides/action-batches/'>more
details</a>)
callback:
type: object
properties:
url:
type: string
description: The callback URL for the webhook target. If using this field, please also specify a sharedSecret.
sharedSecret:
type: string
description: A shared secret that will be included in the requests sent to the callback URL. It can
be used to verify that the request was sent by Meraki. If using this field, please also specify an
url.
httpServer:
type: object
properties:
id:
type: string
description: The webhook receiver ID that will receive information. If specifying this, please leave
the url and sharedSecret fields blank.
description: The webhook receiver used for the callback webhook.
payloadTemplate:
type: object
properties:
id:
type: string
description: The ID of the payload template. Defaults to 'wpt_00005' for the Callback (included)
template.
description: The payload template of the webhook used for the callback
x-release-stage: general_availability
description: Details for the callback. Please include either an httpServerId OR url and sharedSecret
example:
confirmed: true
synchronous: true
actions:
- resource: /devices/QXXX-XXXX-XXXX/switch/ports/3
operation: create
callback:
url: https://webhook.site/28efa24e-f830-4d9f-a12b-fbb9e5035031
sharedSecret: secret
httpServer:
id: aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20vd2ViaG9va3M=
payloadTemplate:
id: wpt_2100
required:
- actions
required: true
responses:
'201':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: ID of the action batch. Can be used to check the status of the action batch at /organizations/{organizationId}/actionBatches/{actionBatchId}
organizationId:
type: string
description: ID of the organization this action batch belongs to
confirmed:
type: boolean
description: Flag describing whether the action should be previewed before executing or not
synchronous:
type: boolean
description: Flag describing whether actions should run synchronously or asynchronously
status:
type: object
properties:
completed:
type: boolean
description: Flag describing whether all actions in the action batch have completed
failed:
type: bool
# --- truncated at 32 KB (1288 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-meraki/refs/heads/main/openapi/cisco-meraki-organizations-api-openapi.yml