id: meraki
name: Cisco Meraki
version: 1.0.0
description: "Cisco Meraki (Dashboard API v1) — network visibility: list organizations, networks and devices, and list clients on a network. API-key authentication; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: list organizations/networks/devices, list network clients."
category: network

# Per-instance configuration. Auth header 'X-Cisco-Meraki-API-Key: <api_key>'.
config_schema:
  properties:
    api_key:
      type: string
      description: "Meraki Dashboard API key"
      x-soar-sensitive: true
  required:
    - api_key

commands:
  - id: list_organizations
    name: meraki-list-organizations
    description: "List organizations the API key can access."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }
  - id: list_networks
    name: meraki-list-networks
    description: "List networks in an organization."
    risk: read
    inputs_schema:
      properties:
        organization_id: { type: string, description: "Organization ID" }
      required: [organization_id]
    outputs_schema: { properties: {} }
  - id: list_devices
    name: meraki-list-devices
    description: "List devices in an organization."
    risk: read
    inputs_schema:
      properties:
        organization_id: { type: string, description: "Organization ID" }
      required: [organization_id]
    outputs_schema: { properties: {} }
  - id: list_clients
    name: meraki-list-clients
    description: "List clients seen on a network."
    risk: read
    inputs_schema:
      properties:
        network_id: { type: string, description: "Network ID" }
        timespan: { type: number, description: "Look-back window in seconds (default 86400)" }
      required: [network_id]
    outputs_schema: { properties: {} }

  - id: test_connection
    name: meraki-test-connection
    description: "Verify the API key (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }