SuperAPI AI 工具集

custom-object-management

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:管理 HubSpot 自定义 CRM 对象架构,即发现、创建、更新和删除自定义对象类型定义。权威依据是 hubspot schemas --help,子命令为 list、get、create、update(仅元数据)、delete(破坏性)。

主要能力:列出已有架构并区分 source(custom 等);查看单个架构完整定义,包括 properties、associations、labels、requiredProperties、primaryDisplayProperty、fullyQualifiedName;创建新架构;仅更新标签与描述;删除架构及其全部记录。

必要用法:list/get/create/update 可在 OAuth 登录或服务密钥下运行;delete 仅限服务密钥(AppTokenOnly),需设置 HUBSPOT_ACCESS_TOKEN。所有命令遵循 bulk-operations 的 JSONL 约定。创建时可先 cat equipment-schema.json | hubspot schemas create --dry-run 预览,再 hubspot schemas create --file equipment-schema.json 执行;创建后新增属性用 hubspot properties create --type <name>。更新示例:echo '{"labels":{"singular":"Device","plural":"Devices"}}' | hubspot schemas update --type equipment。删除不可逆,须三步:hubspot schemas delete --type equipment --dry-run 先预览,再 hubspot schemas delete --type equipment --digest <hash> --confirm equipment,且需在 5 分钟内完成;可用 hubspot history --since 24h --kind MetadataDestroy 审计。

限制与说明:update 只改标签与描述,属性编辑走 properties 命令;架构删除会永久移除该类型全部记录;其他记录 CRUD、搜索、关联、批量 upsert 不在本技能内,参见 bulk-operations 与 crm-lookup。其他细节资料未提供。