---
title: "Edit Collection"
method: PUT
path: "/Collections/{id}"
---

# Edit Collection

`PUT /Collections/{id}`

## Request

- Base URL: `https://api.shopmy.us/v1/Partners`
- URL: `https://api.shopmy.us/v1/Partners/Collections/{id}`
- Auth: API key in header `Authorization`

This API route allows a developer application to edit one of the authenticated user's ShopMy collections. This route requires the user to permission your app for the write_collections scope. Collection privacy cannot be updated through this endpoint.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string: Collection name (optional)
  - `description` string: Collection description (optional)
  - `social_links` union: Social URLs attached to the collection. Each link must be an HTTPS Instagram, TikTok, or YouTube URL. May be sent as an array or comma-separated string (optional).
    - string[]
    - string
  - `Section_id` integer: Section to move the collection into. The section must belong to the authenticated user (optional).

## Response `200`

200

- object
  - `success` boolean, required
  - `collection` Collection, required
    - `id` integer, required
    - `name` string, required
    - `description` string
    - `image` string, nullable
    - `social_links` string[], required
    - `private` boolean, required
    - `Section_id` integer, nullable
    - `url` string, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403

---

[API](https://skmtc.dev/shopmy/apis/shopmy-for-developers.md) - [All operations](https://skmtc.dev/shopmy/apis/shopmy-for-developers/llms.txt) - [OpenAPI document](https://skmtc.dev/shopmy/apis/shopmy-for-developers/revisions/9beecb9e11f7?raw)