Cisco Meraki Deployments API
The Deployments API from Cisco Meraki — 8 operation(s) for deployments.
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/cisco-meraki-secure-connect-deployments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.0.0
info:
title: Meraki Integrated API for Secure Connect — Deployments
description: "The Cisco Meraki Integrated API for Secure Connect is a modern REST API based on the OpenAPI specification.\n\
\ ---\n\n [API Documentation](https://meraki.io/api)\n\n [Meraki Homepage](https://www.meraki.com)\n"
version: 1.8.0
contact:
name: Meraki Developer Community
url: https://meraki.io/community
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 'Deployments'. Operations and schemas are the provider's,
unmodified.
x-evidence:
- type: source
url: https://github.com/meraki/secure-connect-openapi/blob/main/secure_connect_oas_beta.json
- type: raw
url: https://raw.githubusercontent.com/meraki/secure-connect-openapi/main/secure_connect_oas_beta.json
servers:
- url: https://api.meraki.com/{basePath}
variables:
basePath:
default: api/secureConnect/v1
security:
- meraki_api_key: []
- bearerAuth: []
tags:
- name: Deployments
paths:
/organizations/{organizationId}/datacenters:
get:
summary: List Data Centers
operationId: getDatacenters
security:
- meraki_api_key: []
description: 'List the information about the IPsec-enabled data centers.
The data center information includes the IP address and location details.'
tags:
- Deployments
- Data Center
- Umbrella
responses:
'200':
description: OK
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
description: The information about the IPsec-enabled data centers.
properties:
continents:
type: array
description: The list of continents.
items:
type: object
description: The properties of the continent.
properties:
cities:
type: array
description: The list of cities.
items:
type: object
description: The properties of the city.
properties:
latitude:
type: string
description: The latitude of the city.
example: '52.354662'
longitude:
type: string
description: The longitude of the city.
example: '4.955532'
name:
type: string
description: The name of the city.
example: Amsterdam
dc:
type: string
description: The domain of the data center located in the city.
example: ams1.edc
range:
type: string
description: The IP or CIDR range of the data center that is located in the city.
example: 146.112.98.2/32
fqdn:
type: string
example: eu2-b.vpn.sig.umbrella.com
description: The FQDN associated with the city. Returns the FQDN if available.
name:
type: string
description: The name of the continent.
example: Europe
example:
continents:
- cities:
- latitude: '52.354662'
longitude: '4.955532'
name: Amsterdam
dc: ams1.edc
range: 146.112.98.2/32
fqdn: eu2-b.vpn.sig.umbrella.com
name: Europe
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
minProperties: 3
required:
- statusCode
- error
- txId
properties:
statusCode:
type: integer
example: 400
description: HTTP status code
error:
type: string
example: Validation Error
description: a brief description of the error
txId:
type: string
example: 86e189a6-0124-47d3-a32c-25ff3f07deaf
description: a unique hex number that can be used for debugging
validationErrors:
type: object
properties:
someProperty:
type: string
example: must not be empty
description: the name of the property failing validation.
'401':
description: Unauthorized
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
description: Unauthorized
type: object
properties:
statusCode:
type: integer
example: 401
description: HTTP status code
error:
type: string
example: Unauthorized
description: The authorization header is missing or the token is unauthorized
message:
type: string
description: Detailed error message
'403':
description: Forbidden
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
description: Forbidden
type: object
properties:
statusCode:
type: integer
example: 403
description: HTTP status code
error:
type: string
example: Forbidden, Invalid authentication credentials
description: a brief description of the error
message:
type: string
description: Detailed error message
'404':
description: Not found
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
description: Not Found
type: object
properties:
statusCode:
type: integer
example: 404
description: HTTP status code
error:
type: string
example: Not Found
description: A brief description of the error
message:
type: string
description: Detailed error message
'500':
description: Internal Server Error
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
minProperties: 3
required:
- statusCode
- error
- txId
properties:
statusCode:
type: integer
example: 500
description: HTTP status code
error:
type: string
example: Internal Server Error
description: a brief description of the error
txId:
type: string
example: 86e189a6-0124-47d3-a32c-25ff3f07deaf
description: a unique hex number that can be used for debugging
parameters:
- name: organizationId
in: path
description: Organization ID associated with this resource.
required: true
schema:
type: integer
/organizations/{organizationId}/networkDevices:
post:
tags:
- Deployments
- Network Devices
- Umbrella
summary: Create Network Device
description: Create a network device.
operationId: createNetworkDevice
security:
- meraki_api_key: []
requestBody:
content:
application/json:
schema:
type: object
minProperties: 4
required:
- model
- macAddress
- name
- serialNumber
properties:
model:
type: string
example: ModelName
maxLength: 128
pattern: '[0-9A-Za-z_.-]{1,128}'
description: The model name of the device. Must be unique to your organization.
macAddress:
type: string
example: 0123456789ab
maxLength: 12
minLength: 12
pattern: '[0-9A-Fa-f]{12}'
description: 'The MAC address of the device. The unique MAC address may include
up to 12 characters and must not contain hyphens or colons.'
name:
type: string
example: label1
maxLength: 50
minLength: 1
description: 'The name of the device. The name is a sequence of characters with a length from 1 through
50.
The name must be unique in your organization.'
serialNumber:
type: string
example: 12345a
maxLength: 255
description: The serial number of the device.
tag:
type: string
description: A text tag that describes the device or this origin, which is assigned to the device. Provide
a tag that is unique to your organization.
maxLength: 50
example:
model: The model name of the device.
macAddress: 0123456789ab
name: A name for the device.
serialNumber: 12345a
responses:
'201':
description: Created
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
description: The network device object.
minProperties: 7
required:
- originId
- deviceId
- deviceKey
- name
- serialNumber
- createdAt
- organizationId
properties:
originId:
type: integer
example: 35872943
minimum: 1
description: 'The unique global identifier for this traffic source (origin). Use
the origin ID to manage the device. The origin ID is not used by the device.'
deviceId:
type: string
example: 0123456789abcdef
maxLength: 16
minLength: 15
description: The unique identifier for the specific network device. Insert the identifier into the EDNS
packets.
deviceKey:
type: string
example: ModelName-0123456789ab
description: 'A descriptive unique identifier for the device. Not used by the
device.'
name:
type: string
example: APIDemoDevice
description: The name of the device.
minLength: 1
serialNumber:
type: string
example: 12345a
description: The serial number of the device.
createdAt:
type: string
format: date-time
example: '2017-09-22T04:18:51.000Z'
description: The time when the device was created. Specify an ISO 8601-formatted timestamp.
organizationId:
type: integer
description: The ID of the organization.
example: 1234
minimum: 1
example:
originId: 35872943
deviceId: 0123456789abcdef
deviceKey: ModelName-0123456789ab
name: APIDemoDevice
serialNumber: 12345a
createdAt: '2021-09-22T04:18:51.000Z'
organizationId: 1234
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
description: The information about the error condition.
properties:
message:
type: string
description: The message associated with the error condition.
error:
type: string
description: The status code for the error condition.
example:
message: Unauthorized request
'403':
description: Forbidden
content:
application/json:
schema:
type: object
description: The information about the error condition.
properties:
message:
type: string
description: The message associated with the error condition.
error:
type: string
description: The status code for the error condition.
example:
message: Forbidden
'404':
description: Not Found
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
'500':
description: Internal Server Error
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
parameters:
- name: organizationId
in: path
description: Organization ID associated with this resource.
required: true
schema:
type: integer
get:
tags:
- Deployments
- Network Devices
- Umbrella
summary: List Network Devices
description: List the network devices.
operationId: getAllNetworkDevices
security:
- meraki_api_key: []
responses:
'200':
description: OK
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: array
description: The list of networks devices.
items:
type: object
description: The network device object.
minProperties: 7
required:
- originId
- deviceId
- deviceKey
- name
- serialNumber
- createdAt
- organizationId
properties:
originId:
type: integer
example: 35872943
minimum: 1
description: 'The unique global identifier for this traffic source (origin). Use
the origin ID to manage the device. The origin ID is not used by the device.'
deviceId:
type: string
example: 0123456789abcdef
maxLength: 16
minLength: 15
description: The unique identifier for the specific network device. Insert the identifier into the EDNS
packets.
deviceKey:
type: string
example: ModelName-0123456789ab
description: 'A descriptive unique identifier for the device. Not used by the
device.'
name:
type: string
example: APIDemoDevice
description: The name of the device.
minLength: 1
serialNumber:
type: string
example: 12345a
description: The serial number of the device.
createdAt:
type: string
format: date-time
example: '2017-09-22T04:18:51.000Z'
description: The time when the device was created. Specify an ISO 8601-formatted timestamp.
organizationId:
type: integer
description: The ID of the organization.
example: 1234
minimum: 1
example:
- originId: 35872943
deviceId: 0123456789abcdef
deviceKey: ModelName-0123456789ab
name: APIDemoDevice
serialNumber: 12345a
createdAt: '2021-09-22T04:18:51.000Z'
organizationId: 1234
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
description: The information about the error condition.
properties:
message:
type: string
description: The message associated with the error condition.
error:
type: string
description: The status code for the error condition.
example:
message: Unauthorized request
'403':
description: Forbidden
content:
application/json:
schema:
type: object
description: The information about the error condition.
properties:
message:
type: string
description: The message associated with the error condition.
error:
type: string
description: The status code for the error condition.
example:
message: Forbidden
'404':
description: Not Found
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
'500':
description: Internal Server Error
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
parameters:
- name: organizationId
in: path
description: Organization ID associated with this resource.
required: true
schema:
type: integer
/organizations/{organizationId}/networkDevices/{originId}:
patch:
tags:
- Deployments
- Network Devices
- Umbrella
summary: Update Network Device
description: Update a network device.
operationId: updateNetworkDevice
security:
- meraki_api_key: []
parameters:
- name: organizationId
in: path
description: Organization ID associated with this resource.
required: true
schema:
type: integer
- name: originId
in: path
description: The origin ID of the network device.
required: true
schema:
type: integer
minimum: 1
format: int32
requestBody:
content:
application/json:
schema:
type: object
required:
- name
description: Update the network device information.
properties:
name:
type: string
example: label1
maxLength: 50
minLength: 1
description: 'The name of the device. The name is a sequence of characters with a length from 1 through
50.
The name must be unique in your organization.'
example:
name: MyDeviceName
example:
name: NetworkDevice01
description: Update the properties of the network device.
required: true
responses:
'200':
description: OK
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
description: The network device object.
minProperties: 7
required:
- originId
- deviceId
- deviceKey
- name
- serialNumber
- createdAt
- organizationId
properties:
originId:
type: integer
example: 35872943
minimum: 1
description: 'The unique global identifier for this traffic source (origin). Use
the origin ID to manage the device. The origin ID is not used by the device.'
deviceId:
type: string
example: 0123456789abcdef
maxLength: 16
minLength: 15
description: The unique identifier for the specific network device. Insert the identifier into the EDNS
packets.
deviceKey:
type: string
example: ModelName-0123456789ab
description: 'A descriptive unique identifier for the device. Not used by the
device.'
name:
type: string
example: APIDemoDevice
description: The name of the device.
minLength: 1
serialNumber:
type: string
example: 12345a
description: The serial number of the device.
createdAt:
type: string
format: date-time
example: '2017-09-22T04:18:51.000Z'
description: The time when the device was created. Specify an ISO 8601-formatted timestamp.
organizationId:
type: integer
description: The ID of the organization.
example: 1234
minimum: 1
example:
originId: 35872943
deviceId: 0123456789abcdef
deviceKey: ModelName-0123456789ab
name: APIDemoDevice
serialNumber: 12345a
createdAt: '2021-09-22T04:18:51.000Z'
organizationId: 1234
'400':
description: Bad Request
headers:
Content-Type:
schema:
type: string
description: The MIME content type of the response body.
example: application/json
Date:
schema:
type: string
pattern: ^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$
description: The timestamp of the response.
example: '2023-03-14T18:34:25Z'
content:
application/json:
schema:
type: object
properties:
Error:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
description: The information about the error condition.
properties:
message:
type: string
description: The message associated with the error condition.
error:
type: string
description: The status code for the error condition.
# --- truncated at 32 KB (142 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-meraki/refs/heads/main/openapi/cisco-meraki-secure-connect-deployments-api-openapi.yml