## Update a collection

`PUT https://getkollek.com/api/collections/{collection}`

Update a collection. All the fields below are written on every call, so send the full object, not only the fields that changed.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Path parameters

- `collection` (integer, required): The ID of the collection.

### Body parameters

- `name` (string, required): The name of the collection. Maximum 255 characters.
- `description` (string, optional): A description of the collection. Maximum 2000 characters.
- `emoji` (string, optional): The emoji shown next to the collection name. One of 📦, 📚, 💿, 🃏, 🍷, 🎮, 🧸, 🪙, 🖼️, ⌚, 👟 or 📷.
- `visibility` (string, required): Who the collection is meant for. One of private, shared or public. The setting is recorded but not enforced yet.
- `currency` (string, optional): The three-letter currency code used for item values, such as USD or EUR.

**Returns:** The updated collection object.

### Example request

```bash
curl https://getkollek.com/api/collections/1 \
  -X PUT \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Comics",
    "description": "Silver age Marvel issues.",
    "emoji": "📚",
    "visibility": "private",
    "currency": "USD"
}'
```

### Example response

`Status: 200`

```json
{
    "data": {
        "type": "collection",
        "id": "1",
        "attributes": {
            "uuid": "9e2f6c1a-4b3d-4b6e-9a2f-0c1d2e3f4a5b",
            "name": "My Comics",
            "description": "Silver age Marvel issues.",
            "emoji": "📚",
            "visibility": "private",
            "currency": "USD",
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/collections/1"
        }
    }
}
```