Skip to main content
Glama

reassign

by app.reassign
OverviewDiscussionsAdmin

Manage categories

manage_categories
Destructive

Create, update, or delete areas (categories / groups / colour-coded labels) and activity types (tags / fill patterns) — one or many in a single call. Pass areas and/or activityTypes, each an array of ops: {op:"create", name, color?} / {op:"update", id, name?, color?} / {op:"delete", id, reassignTo?} for areas; pattern instead of color for activity types (valid patterns: solid, hatch_r, hatch_l, cross, horizontal, vertical, grid, dots, waves, chevron). Colours are lowercase "#rrggbb"; omit color or pattern to auto-pick. Editing a shared global default forks it into your own copy, so the returned id may differ — each result reports the effective id (and forkedFrom). Delete only your own (non-global) entries; if events still use one, pass reassignTo (another id) to move them first. Names are deduplicated case- and whitespace-insensitively: creating one that matches an existing area/type is rejected (reuse the existing id instead). A create or update result is the created/updated row; a delete result lists deletedIds (plus movedEvents after a reassign). Every call that writes returns one undoToken + expiresAt; pass it to undo to reverse the whole call. Atomic by default: if any op is invalid nothing is written; pass partial: true for best-effort. Create areas/types here first, then reference the returned ids in write_events.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
areasNo
partialNoBest-effort mode instead of the default all-or-nothing.
activityTypesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / activityTypes / items / oneOf
      Previous value: -[
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "create",
-        "type": "string"
-      },
-      "pattern": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "update",
-        "type": "string"
-      },
-      "order": {
-        "type": "number"
-      },
-      "pattern": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "op": {
-        "const": "delete",
-        "type": "string"
-      },
-      "reassignTo": {
-        "description": "Another activity type's id to move events onto; required if events still use this type.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "create",
+        "type": "string"
+      },
+      "pattern": {
+        "description": "A fill pattern; omit to auto-pick.",
+        "enum": [
+          "solid",
+          "hatch_r",
+          "hatch_l",
+          "cross",
+          "horizontal",
+          "vertical",
+          "grid",
+          "dots",
+          "waves",
+          "chevron"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "update",
+        "type": "string"
+      },
+      "order": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      },
+      "pattern": {
+        "description": "A fill pattern; omit to auto-pick.",
+        "enum": [
+          "solid",
+          "hatch_r",
+          "hatch_l",
+          "cross",
+          "horizontal",
+          "vertical",
+          "grid",
+          "dots",
+          "waves",
+          "chevron"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "op": {
+        "const": "delete",
+        "type": "string"
+      },
+      "reassignTo": {
+        "description": "Another activity type's id to move events onto; required if events still use this type.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  }
+]
    • changedInput schema / properties / areas / items / oneOf
      Previous value: -[
-  {
-    "properties": {
-      "color": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "create",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "color": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "update",
-        "type": "string"
-      },
-      "order": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "op": {
-        "const": "delete",
-        "type": "string"
-      },
-      "reassignTo": {
-        "description": "Another area's id to move events onto; required if events still use this area.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "color": {
+        "description": "Lowercase \"#rrggbb\"; omit to auto-pick.",
+        "pattern": "^#[0-9a-f]{6}$",
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "create",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "color": {
+        "description": "Lowercase \"#rrggbb\"; omit to auto-pick.",
+        "pattern": "^#[0-9a-f]{6}$",
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "update",
+        "type": "string"
+      },
+      "order": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "op": {
+        "const": "delete",
+        "type": "string"
+      },
+      "reassignTo": {
+        "description": "Another area's id to move events onto; required if events still use this area.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  }
+]
  2. Changed3 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedInput schema / properties / activityTypes / items / oneOf
      Previous value: -[
-  {
-    "properties": {
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "create",
-        "type": "string"
-      },
-      "pattern": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "update",
-        "type": "string"
-      },
-      "pattern": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "op": {
-        "const": "delete",
-        "type": "string"
-      },
-      "reassignTo": {
-        "description": "Another activity type's id to move events onto; required if events still use this type.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "create",
+        "type": "string"
+      },
+      "pattern": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "update",
+        "type": "string"
+      },
+      "order": {
+        "type": "number"
+      },
+      "pattern": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "op": {
+        "const": "delete",
+        "type": "string"
+      },
+      "reassignTo": {
+        "description": "Another activity type's id to move events onto; required if events still use this type.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  }
+]
    • changedInput schema / properties / areas / items / oneOf
      Previous value: -[
-  {
-    "properties": {
-      "color": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "create",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "color": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "name": {
-        "maxLength": 60,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "update",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "op": {
-        "const": "delete",
-        "type": "string"
-      },
-      "reassignTo": {
-        "description": "Another area's id to move events onto; required if events still use this area.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "id"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "color": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "create",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "color": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "maxLength": 60,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "update",
+        "type": "string"
+      },
+      "order": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "op": {
+        "const": "delete",
+        "type": "string"
+      },
+      "reassignTo": {
+        "description": "Another area's id to move events onto; required if events still use this area.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "id"
+    ],
+    "type": "object"
+  }
+]
  3. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Annotations indicate destructiveHint=true, and the description thoroughly explains the destructive behaviors: deletion only of own entries, forking of shared global defaults, reassignment of events, atomicity vs partial mode, deduplication, and undo support. It adds significant context beyond the annotation, covering what happens on each op and the side effects. No contradiction with annotations.

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 description is long but dense and well-organized. It front-loads the core purpose and then systematically covers ops, parameters, forking, deletion rules, deduplication, output format, undo, atomicity, and workflow. Each sentence adds unique value; there is minimal redundancy. While lengthy, the complexity of the tool justifies it, and the structure (with semicolons and parentheticals) keeps it readable.

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 tool's complexity (two resource types, multiple ops, nested schemas, no output schema), the description covers all necessary operational details: op structures, required fields, valid patterns and colors, forking behavior, deletion constraints, reassignment, deduplication, atomic vs partial, undo token, and integration with write_events. The only minor omission is the 'order' field (only in schema), but it's not essential for core usage. Overall, an agent can correctly invoke this tool without further clarification.

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

Parameters5/5

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

Schema description coverage is only 33% (partial, color, pattern, reassignTo have brief descriptions). The tool description compensates comprehensively: it explains the structure of ops, required fields, optional fields like color/pattern with valid values, the meaning of reassignTo, the behavior of partial, and the semantics of areas vs activityTypes. It details the op variants (create/update/delete) and their required fields, effectively documenting all parameters beyond the schema.

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

Purpose5/5

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

Description explicitly states the tool creates, updates, or deletes areas and activity types, with specific synonyms for each. It clearly distinguishes the resource types and operations, and the 'Create areas/types here first...' guidance sets it apart from sibling tools like write_events. No ambiguity about what the tool does.

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 description gives clear when-to-use context: 'Create areas/types here first, then reference the returned ids in write_events.' It also advises on deletion constraints (only own entries) and reassignment when events still use an entry. It doesn't explicitly name alternative tools or say when not to use it, but the workflow is well implied. Lacks explicit exclusion of alternatives, but adequate.

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

All reassign toolsInspect
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