---
title: "Transition Lifecycle"
method: PATCH
path: "/v1/collections/{collection_identifier}/lifecycle"
tags: ["Collection Lifecycle"]
---

# Transition Lifecycle

`PATCH /v1/collections/{collection_identifier}/lifecycle`

Transition a collection's storage tier. 'cold' evicts from the vector store (vectors searchable via object storage). 'active' rehydrates back to the vector store. 'archived' permanently removes vectors.

## Path parameters

- `collection_identifier` string, required — Collection ID or name

## Request body

- TransitionLifecycleRequest
  - `lifecycle_state` 'active' | 'cold' | 'archived', required
  - `async_transition` boolean — If False, block until the transition completes

## Response `200`

Successful Response

- LifecycleStatusResponse
  - `collection_id` string, required
  - `lifecycle_state` 'active' | 'cold' | 'archived', required
  - `s3_vector_index` string, nullable
  - `vector_document_count` integer, nullable
  - `s3_vector_count` integer, nullable
  - `last_transitioned_at` string, date-time, nullable
  - `task_id` string, nullable
  - `warning` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/220a3b263fda/schema)