---
title: "Cut the next immutable version of a schema (bumps version, deprecates the source)."
method: POST
path: "/v1/credential-schemas/{uuid}/versions"
tags: ["Credentials"]
---

# Cut the next immutable version of a schema (bumps version, deprecates the source).

`POST /v1/credential-schemas/{uuid}/versions`

Create the next immutable version of a credential schema. You provide the attributes for the new version. The response returns the new version and the full version family.

## Path parameters

- `uuid` string, required

## Request body

- object
  - `attributes` object[], required — Claim attributes for the new schema version.
    - `name` string, required — Claim name to include in the new schema version.
    - `sd` boolean, required — Whether the claim supports selective disclosure.

## Response `201`

The next schema version was created.

- object
  - `uuid` string, uuid — Unique identifier of the new credential schema version.
  - `name` string — Human-readable schema name.
  - `vct` string — VCT (Verifiable Credential Type) value embedded in credentials issued from this schema.
  - `version` string — Schema version string for the new version.
  - `format` string — Credential format. The captured value is `sd_jwt_vc`, the SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) format.
  - `attributes` object[] — Claim attributes stored on the new schema version.
    - `name` string — Claim name as it appears in the credential.
    - `sd` boolean — Whether the claim supports selective disclosure.
  - `branding` object — Wallet branding object returned with the schema. The captured example is an empty object.
  - `revocable` boolean — Whether issued credentials from this schema can be revoked.
  - `status` string — Lifecycle status of the new schema version.
  - `supersedes` string, uuid, nullable — Schema UUID that this version supersedes.
  - `created_at` string, date-time — Timestamp when the new schema version was created.
  - `versions` object[] — Version family for this schema.
    - `uuid` string, uuid — Unique identifier of this schema version.
    - `vct` string — VCT (Verifiable Credential Type) value for this schema version.
    - `version` string — Version string for this schema version.
    - `status` string — Lifecycle status of this schema version.
    - `supersedes` string, uuid, nullable — Schema UUID that this version supersedes. Null means this is the first version.
    - `is_latest` boolean — Whether this is the latest version in the family.
    - `issued_count` integer — Number of credentials issued from this schema version.
    - `created_at` string, date-time — Timestamp when this schema version was created.

---

[API](https://skmtc.net/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.net/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/revisions/e4eddba66557/schema)