Tool

update_area

Update areaChanges data

Description

Rename an area, rewrite its description, or merge it into another. Merging moves all its pins and keeps the old name as an alias. Workspace owners only.

Parameters

workspacestring

Workspace slug. Required when you're in several workspaces. - acme: Acme (acme/api) - acme-mobile: Acme Mobile (acme/ios)

Your workspaces, e.g.acmeacme-mobile

areastringrequired

The area to change. acme (acme/api): - auth: Sign-in, sessions and permissions - payments: Billing, invoices and checkout acme-mobile (acme/ios): - offline: Sync and offline storage

Your workspace's areas, e.g.authofflinepayments

rename_tostring

2–40 characters

descriptionstring

3–200 characters

merge_intostring

Area to merge this one into.

Your workspace's areas, e.g.authofflinepayments

Response

An example. The result sits in the same envelope as every tool's; see Responses.

JSON

{
  "workspace": {
    "slug": "acme",
    "name": "Acme"
  },
  "result": {
    "area": {
      "name": "identity",
      "description": "Sign-in, sessions and permissions",
      "counts": {
        "open": 12,
        "claimed": 2,
        "resolved_last_30d": 7
      },
      "aliases": [
        "auth"
      ],
      "created_by": "Sam",
      "created_at": "2026-09-20T10:00:00.000Z"
    },
    "areas": [
      {
        "name": "identity",
        "description": "Sign-in, sessions and permissions",
        "counts": {
          "open": 12,
          "claimed": 2,
          "resolved_last_30d": 7
        }
      },
      {
        "name": "payments",
        "description": "Billing, invoices and checkout",
        "counts": {
          "open": 12,
          "claimed": 2,
          "resolved_last_30d": 7
        }
      }
    ]
  }
}

Input schema

Exactly what tools/list sends your agent.

JSON

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Workspace slug. Required when you're in several workspaces.\n- acme: Acme (acme/api)\n- acme-mobile: Acme Mobile (acme/ios)",
      "type": "string",
      "enum": [
        "acme",
        "acme-mobile"
      ]
    },
    "area": {
      "type": "string",
      "enum": [
        "auth",
        "offline",
        "payments"
      ],
      "description": "The area to change.\nacme (acme/api):\n- auth: Sign-in, sessions and permissions\n- payments: Billing, invoices and checkout\nacme-mobile (acme/ios):\n- offline: Sync and offline storage"
    },
    "rename_to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 40
    },
    "description": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200
    },
    "merge_into": {
      "description": "Area to merge this one into.",
      "type": "string",
      "enum": [
        "auth",
        "offline",
        "payments"
      ]
    }
  },
  "required": [
    "area"
  ]
}