---
title: "SetCollectionState"
method: POST
path: "/kythene.v1.KytheneService/SetCollectionState"
tags: ["kythene.v1.KytheneService"]
---

# SetCollectionState

`POST /kythene.v1.KytheneService/SetCollectionState`

## Request

- Base URL: `https://kythene.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kythene.com/kythene.v1.KytheneService/SetCollectionState`
- Auth: none required

SetCollectionState moves a collection through its lifecycle with one call -
 the aggregate of archive/restore/delete/cancel behind a target state.

## Headers

- `Connect-Protocol-Version` 1, required: Define the version of the Connect protocol
- `Connect-Timeout-Ms` number: Define the timeout, in ms

## Request body

- KytheneV1SetCollectionStateRequest
  - `id` string: id is the collection to move.
  - `state` string: state is the target lifecycle state: "live" - make an archived collection live again (restore); "archived" - archive a live collection, OR cancel a scheduled deletion, leaving the collection archived; "deletion_scheduled" - schedule permanent deletion of an archived collection after the 30-day grace window. This transition still requires delete permission (the domain enforces it), even though the tool is gated on update - an update-only caller is refused here.
  - `space` string: space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

## Response `200`

Success

- KytheneV1SetCollectionStateResponse

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/kythene/apis/kythene-v1.md) · [All operations](https://skmtc.dev/kythene/apis/kythene-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/kythene/apis/kythene-v1/revisions/5a768e642d10?raw)