I don't understand the add_members_to_the_tag function

[chaispaquichui]

Prerequisites

• [X ] Have you tested the operation in the API directly?
• Do you have the latest SDK version?
• Review the compatibility matrix before opening an issue.

Describe the bug

The documentation of this function is very confusing for me

https://dnacentersdk.readthedocs.io/en/latest/api/api.html#dnacentersdk.api.v3_1_3_0.tag.Tag.add_members_to_the_tag

Can you provide a example of how to use it ?

The DNA API only request a payload like this :

{"networkdevice" : ["6eea7bb4-4bb3-4c75-86a6-aa790d17f52d"]}

but the documentation of the function mention the memberType parameter wich is a list of string

I was able to use the function like this :

p = {"networkdevice" : ["6eea7bb4-4bb3-4c75-86a6-aa790d17f52d"]}
dna.tag.add_members_to_the_tag(id='3529f14c-7e95-49ec-a80a-22507b1113af', payload=p)

But I don't know if it's the right way to use it. Can you tell me what is the purpose of the memberType parameter ? Thanks

[bvargasre]

Hi @chaispaquichui,
I'm sharing two screenshots of the API. Here you can see the format and also memberType is required.

---

https://developer.cisco.com/docs/dna-center/add-members-to-the-tag/

{ "memberType": [ "string" ] }

Best regards

[chaispaquichui]

Thank for your answer.

Unfortunately the documentation is misleading in this case... The key "memberType" is only a placeholder.

As you can see in the documentation :

"memberType can be retrieved by the API /dna/intent/api/v1/tag/member/type"

In reality, you can add tag to "networkdevice" and "interface" in the DNA center.

So in reality a payload look like this :

{
"networkdevice" : ["id_of_device"]
}

or like this :

{
"interface" : ["id_of_interface"]
}

Sorry if it's not very clear, english is not my native language :)

I was able to put the piece together by looking at this code :

https://github.com/CiscoDevNet/DNAC-Tag/blob/cb1c34e7c42fe8c5b99f2df642cdf73b34a1a8b7/tag.py#L50

So if I understand correctly, the function "add_members_to_the_tag" is broken in is current form