Get Organizations - what is the "Management" Object?

[JVlajcic]

Hi, we're looking at the response schema in the GET Organizations (Get Organizations - Meraki Dashboard API v1 - Cisco Meraki Developer Hub) payload and we're trying to determine what this object named "Management" is. We use this API today to pull organization IDs for use in other calls and for quoting of renewals or conversions to Meraki Enterprise Agreements. Does anyone know what the "name" and "value" represent inside of "Management" or where they are used? 

The information in the Schema documentation says: "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."

In the sample payload it looks like it's referencing an MSP instance - is this something that is a partner identifier for someone providing managed services? Or is this a parent object for Organization ID - for instance when a customer has multiple organization IDs or dashboard instances? 

I think this is something that was added recently to the Get Organizations API but am not sure. Does anyone know what these values represent? 

Get Organizations Response Schema:

• object[]
  • id:string

    Organization ID

  • name:string

    Organization name

  • url:string

    Organization URL

  • +api:object

    API related settings

  • +cloud:object

    Data for this organization

  • +licensing:object

    Licensing related settings

  • +management:object

    Information about the organization's management system

 (object in question highlighted)

[RaphaelL]

Hi ,

This is what is returned on all my orgs : 

"management": {
      "details": [
        {
          "name": "IP restriction mode for dashboard",
          "value": "client allowed"
        },
        {
          "name": "customer number",
          "value": "xxxxxxx"
        }
      ]
    }

[RaphaelL]

So yes , it might be any of these things : 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.

MSP is infact for people that manage multiple dashboards for customers.

[JVlajcic]

Thank you, I appreciate you sending the example over of what you see in your dash. Any idea how this is set or who sets it? We're seeing multiple org IDs combined into Meraki EAs so one of the theories was that this was a "parent" identifier that was added in for some of the later buying models. 

In your example, is that Name and Value something you defined in your instance? 

[RaphaelL]

No it is not set up by us. 

It is shown in the payload because we have set IP restriction on our dashboard.

The key "value" is the same for all our orgs under the same EA

[PhilipDAth · Accepted solution]

I think it is referring to this:

Scroll to the very bottom and you will see:

You could use this to link the Meraki Dashboard to an internal customer ID.

[JVlajcic]

Thank you for your reply! That was a great call out - I did look at that part of the dashboard, update the MSP ID and test the API. You're correct that does show up in the Management section! 

Interestingly though, it's not the customer number that was in the example or the other replies. It looks like that's one "tag" among many that can be applied to the customer instance. Now to hunt around for where the others are in the dashboard...

Thanks! 

        "management": {

            "details": [

                {

                    "name": "MSP ID",

                    "value": "789789789"

                },

                {

                    "name": "customer number",

                    "value": "xxxxxxx"

                }

            ]

        }

[mlefebvre1]

MSP ID is exactly what it sounds like, an identifier for a partner providing managed services. If you are an MSP, this should be populated with your MSP ID in your orgs, if you are not an MSP but you contract an MSP to manage your existing dashboard they would populate this with their ID.