Tools Adopt Catalogue Item
tools_adopt_catalogue_itemDestructive
Adopt an article into your crib — the machine-library instantiate
move: the instance is yours to rename, re-spec and price; the article
stays untouched and catalogue_item_id records the lineage.
Adopting an article you already have returns the tool you have — never a second copy, and never renamed — and still attaches it to the environments you name.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for your instance, used only when this call creates it; defaults to the article's. If you already own this article, adopting returns the tool you have and leaves its name alone — a name you chose is never overwritten. Rename it with PATCH /tools/{tool_id}. | |
| item_id | Yes | ||
| attach_to_environment_ids | No | Costing environments the adopted tool joins. Omit to let a newly created instance join every current environment; [] to attach nowhere. An environment you do not own is not found. If you already own this article, the environments you name here are joined and every other one is left as it is — adopting again never puts a tool back into an environment you took it out of. |