---
title: "Set App Collection"
method: PUT
path: "/api/v1/apps/{app_id}/collection"
tags: ["apps"]
---

# Set App Collection

`PUT /api/v1/apps/{app_id}/collection`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/apps/{app_id}/collection`
- Auth: none declared

File the app under ``collection_id``, or ungroup it with ``null``.

## Path parameters

- `app_id` string, uuid, required

## Request body

- AppCollectionAssign: Body of ``PUT /apps/{app_id}/collection``; ``null`` removes the app from its collection.
  - `collection_id` string, uuid, nullable, required

## Response `200`

Successful Response

- AppRead
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `user_id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `status` string, required
  - `bundle_url` string, nullable, required
  - `bundle_css` string, nullable, required
  - `bundle_imports` string[], nullable, required
  - `error_message` string, nullable, required
  - `current_version_id` string, uuid, nullable, required
  - `collection_id` string, uuid, nullable
  - `embed_inputs` object[], nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `bindings` BindingRead[]
    - `id` string, uuid, required
    - `entity_id` string, uuid, required
    - `mode` string, required
  - `is_favorite` boolean
  - `data_chat_enabled` boolean
  - `thumbnail_version_id` string, uuid, nullable

## Other responses

- `422`: Validation Error

## Changes

> 61 revisions in range; 1 not diffed.

- **2026-11-02** `68e89013efe0`: 1 info
  - added the optional property `thumbnail_version_id` to the response with the `200` status
- **2026-10-26** `5a6bd3150b8b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/apps/:app_id/collection/put.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/68e89013efe0?raw)