---
title: "Update identity status"
method: PUT
path: "/api/cis/v1/identities/{id}/status"
tags: ["Identities"]
---

# Update identity status

`PUT /api/cis/v1/identities/{id}/status`

Transition identity to a new status. Invalid transitions are rejected.
Valid transitions follow the identity state machine.

## Path parameters

- `id` string, uuid, required

## Headers

- `x-tenant-id` string, required

## Request body

- UpdateStatusRequest
  - `nextStatus` 'PENDING' | 'ACTIVE' | 'IN_REVIEW' | 'DENIED' | 'BLOCKED' | 'FROZEN', required
  - `comment` string
  - `actorId` string

## Response `200`

Status updated

- object
  - `id` string, uuid
  - `status` 'PENDING' | 'ACTIVE' | 'IN_REVIEW' | 'DENIED' | 'BLOCKED' | 'FROZEN'
  - `updatedAt` string, date-time

## Other responses

- `400` — Invalid status transition
- `404` — Resource not found

---

[API](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api.md) · [All operations](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stalela/stalela-cis-customer-identity-service-api/revisions/3065faad0b6b/schema)