# removeObjects

#### removeObjects

Removes objects from the scene by their names or IDs.

#### Signature

```typescript
removeObjects(objectNamesOrIds: string[]): Promise<Object[]>
```

#### Parameters

<table><thead><tr><th width="181.87890625">Name</th><th width="133.96875">Type</th><th width="111.05078125">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>objectNamesOrIds</code></td><td><code>string[]</code></td><td>Yes</td><td>Array of object names or IDs to remove</td></tr></tbody></table>

#### Returns

`Promise<Object[]>` — Array of removed object data, including their properties at the time of removal.

Each object in the array contains:

* `id` — Object ID
* `instanceId` — Instance ID
* `name` — Object name
* `visible` — Visibility state
* `type` — Object type (e.g., `"PRIMITIVE_SPHERE"`, `"PRIMITIVE_BOX"`)
* `position` — Position `{x, y, z}`
* `rotation` — Rotation `{x, y, z, order}`
* `scale` — Scale `{x, y, z}`
* `children` — Array of child objects

#### Usage

```javascript
// Remove single object
const removed = await api.removeObjects(["Sphere"]);
console.log("Removed:", removed[0].name);

// Remove multiple objects
const removed = await api.removeObjects(["Box", "Cylinder"]);
console.log("Removed count:", removed.length);

// Remove by ID
const removed = await api.removeObjects(["8febf451-a4eb-4f3d-8c0c-369512b8595f"]);
```

#### Notes

* This action is **permanent** for the current session — removed objects cannot be restored without reloading the scene
* The method returns the full object data before removal, which can be useful for logging or undo functionality
* If an object name/ID doesn't exist, it will be silently ignored


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.vectary.com/api/model-api/api-reference/removeobjects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.