---
title: "Transition contract status"
method: POST
path: "/groups/{groupId}/artifacts/{artifactId}/contract/status"
tags: ["Contracts"]
---

# Transition contract status

`POST /groups/{groupId}/artifacts/{artifactId}/contract/status`

Transitions the contract status. Valid transitions: DRAFT to STABLE, DRAFT to DEPRECATED, STABLE to DEPRECATED. Reverse transitions are not allowed.

## Request body

- ContractStatusTransition — Request body for transitioning the contract lifecycle status.
  - `status` 'DRAFT' | 'STABLE' | 'DEPRECATED', required — The target lifecycle status. Valid transitions: DRAFT to STABLE, DRAFT to DEPRECATED, STABLE to DEPRECATED.

## Response `200`

The updated contract metadata after the status transition.

- ContractMetadata — Contract metadata for an artifact.
  - `status` 'DRAFT' | 'STABLE' | 'DEPRECATED' — The contract lifecycle status.
  - `ownerTeam` string — The team that owns the contract.
  - `ownerDomain` string — The domain the contract belongs to.
  - `supportContact` string — Support contact email.
  - `classification` 'PUBLIC' | 'INTERNAL' | 'CONFIDENTIAL' | 'RESTRICTED' — Data classification level.
  - `stage` 'DEV' | 'STAGE' | 'PROD' — Promotion stage.
  - `stableDate` string — ISO-8601 date when contract became stable.
  - `deprecatedDate` string — ISO-8601 date when contract was deprecated.
  - `deprecationReason` string — Reason for deprecation.
  - `compatibilityGroup` string — Compatibility group for schema evolution scoping.

## Other responses

- `400` — Common response for all operations that can return a `400` error.
- `404` — Common response for all operations that can return a `404` error.
- `409` — Common response used when an input conflicts with existing data.
- `500` — Common response for all operations that can fail with an unexpected server error.

---

[API](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3.md) · [All operations](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apicurio-registry-api-v3/revisions/c39cb56d7dbc/schema)