# attachments

Returns a list of the bot’s attachments, including HUD objects.

```csharp
// See "LSL Helper Functions" page for this function
smartbotsAPI("attachments", []);
```

```snippet http-api-variables-OmJyUigTgO
```

```snippet http-api-input-basic-parameters-5FcVlaJbq0 action="attachments"
```

```snippet http-api-input-q5yvAagqsZ
skipnames  | optional | Skip attachments whose names contain this substring (case-insensitive)
matchnames | optional | Return only attachments whose names contain this substring (case-insensitive)
matchuuid  | optional | Return only attachment with this UUID
```

```snippet http-api-output-JAwUcmg7i7
total       | The total number of attachments (not affected by filters)
attachments | List of attachments (possibly filtered), with UUIDs and object names separated by newline (`\n`)
```

### Example Output Format

```
UUID1 name of the object 1
UUID2 name of the object 2
...
```

# Comments

* The bot takes about **10–20 seconds after login** to fully load all nearby prims and attachments.  
  Wait a short time before running this command after login.
* This command returns **HUDs and worn attachments**.

# Working with many attachments

The **LSL** `**llHTTPRequest()**` function limits reply size to **2048 bytes (1024 Unicode characters)**.  
If your bot has many attachments, use filters to reduce output size:

* `skipnames` — ignore attachments whose name contains a substring
* `matchnames` — list only attachments whose name contains a specific substring
* `matchuuid` — return a specific attachment by UUID

# Return Value

* `total` — total number of attachments (not affected by filters)
* `attachments` — newline-separated list of UUIDs and attachment names

# Examples

### Example 1 — Get all attachments

```
https://www.mysmartbots.com/api/bot.html?action=attachments&botname=BarKeeeper%20Resident
```

**Response:**

```
9a203028-452d-95b2-5b98-db6daa8c0a70 RASL - MHair D (Brown)
e70e0cbc-ebb5-38ba-bcf3-535af83f9884 Vintage_Glass_White GLASSES SET
bcc100b6-acdf-0a63-c713-db557c5e8c64 Mesh Shoes - Slip-ons: Left
764e0715-4bcb-d1f3-b3fa-21868f7e9635 Mesh Shoes - Slip-ons: Right
25e99b08-10b3-0a6b-bbdf-a42778d9033e Male Party Sunglasses
c402435d-d159-98a1-8149-caa3fcf9df01 -SG-TearOffShirtCuffRGreen
e245e78e-01d8-9b31-c74f-bf8c259ad296 -SG-TearOffShirtCuffLGreen
b2f0643d-df29-4479-fa8e-8ef4ee467c9a -SG-JeansCapriCuffLeft
4fae83f3-ba2f-146f-fc4d-3c2d03e86d43 -SG-JeansCapriCuffRight
```

### Example 2 — Filter by name (“shoes”)

```
https://www.mysmartbots.com/api/bot.html?action=attachments&botname=BarKeeeper%20Resident&matchnames=shoes
```

**Response:**

```
bcc100b6-acdf-0a63-c713-db557c5e8c64 Mesh Shoes - Slip-ons: Left
764e0715-4bcb-d1f3-b3fa-21868f7e9635 Mesh Shoes - Slip-ons: Right
```