Metadata MCP Connector

Update Target Group

update_target_group

Destructive

Update a LinkedIn target group by ID. Name is required, and a targeting update supplies the complete include and exclude configuration. Returns the updated group or an error. Existing targeting omitted from a replacement can be removed.

Input Schema

Name	Required	Description
`name`	Yes	REQUIRED: Target group name. CRITICAL - This is a PUT request so you MUST provide the name even if not changing it. Use retrieve_target_group_by_id to get the current name if you don't have it.
`targeting`	No	Updated targeting configuration (optional). Structure must match create_target_group format. Only update criteria that have isModifiable=true in the current configuration. All criteria IDs/references must come from search_target_group_criteria tool. REQUIRED: Must estimate this targeting first and verify isMatchCountTooSmall is false. NOTE: This is a PUT request - if the target group has targeting, you should provide the complete targeting object.
`target_group_id`	Yes	The unique ID of the target group to update. Must be a positive integer. Use list_target_groups to find the ID by name.

Schema Changelog

Changes observed during successful MCP inspections.

Changed13 schema fields changedOct 25, 2026

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / properties

Added value: +{
+  "criteria": {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "externalId": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {
+                "countries": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                "states": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          ],
+          "description": "Channel criterion values returned by the criteria search tools."
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "data"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "inactive": {
+    "type": "boolean"
+  },
+  "matchCount": {
+    "type": [
+      "integer",
+      "null"
+    ]
+  },
+  "matchCountType": {
+    "type": "string"
+  },
+  "mdAudienceId": {
+    "minimum": 1,
+    "type": "integer"
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / exclude / properties / audiences / items / required
```
Added value: +[
+  "mdAudienceId"
+]
```
addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / properties

Added value: +{
+  "data": {
+    "anyOf": [
+      {
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "externalId": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "name": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      {
+        "additionalProperties": true,
+        "properties": {
+          "countries": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          },
+          "states": {
+            "items": {
+              "type": "integer"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    ],
+    "description": "Channel criterion values returned by the criteria search tools."
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / exclude / properties / criteria / items / required
```
Added value: +[
+  "type",
+  "data"
+]
```
addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / additionalProperties
```
Added value: +true
```

addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / properties

Added value: +{
+  "criteria": {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "data": {
+          "anyOf": [
+            {
+              "items": {
+                "additionalProperties": true,
+                "properties": {
+                  "externalId": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "id": {
+                    "type": [
+                      "string",
+                      "integer"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            {
+              "additionalProperties": true,
+              "properties": {
+                "countries": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                "states": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          ],
+          "description": "Channel criterion values returned by the criteria search tools."
+        },
+        "type": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "data"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "inactive": {
+    "type": "boolean"
+  },
+  "matchCount": {
+    "type": [
+      "integer",
+      "null"
+    ]
+  },
+  "matchCountType": {
+    "type": "string"
+  },
+  "mdAudienceId": {
+    "minimum": 1,
+    "type": "integer"
+  },
+  "name": {
+    "type": "string"
+  },
+  "type": {
+    "type": "string"
+  }
+}

addedInput schema / properties / targeting / properties / include / items / properties / audiences / items / required
```
Added value: +[
+  "mdAudienceId"
+]
```
addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / additionalProperties
```
Added value: +true
```

added

Input schema / properties / targeting / properties / include / items / properties / criteria / items / properties / data / anyOf

Added value: +[
+  {
+    "items": {
+      "additionalProperties": true,
+      "properties": {
+        "externalId": {
+          "type": [
+            "string",
+            "integer"
+          ]
+        },
+        "id": {
+          "type": [
+            "string",
+            "integer"
+          ]
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "countries": {
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      },
+      "states": {
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+]

addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / properties / data / description
```
Added value: +"Channel criterion values returned by the criteria search tools."
```
addedInput schema / properties / targeting / properties / include / items / properties / criteria / items / required
```
Added value: +[
+  "type",
+  "data"
+]
```

First observedSep 16, 2026

TDQS

A4.1/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description goes beyond the structural hints by explaining the 'replacement' semantics of the targeting field. This operational detail informs the agent of the significant behavioral change—that omission means removal—which is vital for a destructive tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The definition is appropriately structured, starting with the primary action and ending with the critical consequences and result. The information is dense but logically ordered.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the extreme complexity of the `targeting` input schema, the description is highly complete because it summarizes the entire behavioral contract: the field must be fully supplied, and it performs a complete replacement operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although the schema coverage is 100%, the description adds crucial meaning by mandating that 'Name is required' and that the `targeting` parameter must be a full replacement set, preventing common schema misinterpretations.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (Update) and the resource (LinkedIn target group) and the identifier (by ID). While the target group update context is clear, it doesn't explicitly distinguish itself from the sibling `create_target_group`.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The definition provides critical guidance by stating that a targeting update must supply the 'complete include and exclude configuration.' It also warns about the risk: 'Existing targeting omitted from a replacement can be removed.'

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Metadata MCP Connector tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?