---
title: "Update a credential type"
method: PUT
path: "/credentials/v1/credential-type"
tags: ["Credentials"]
---

# Update a credential type

`PUT /credentials/v1/credential-type`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/credentials/v1/credential-type`
- Auth: HTTP bearer

## Request body

- S12UserdocumentsV1UpdateDocumentTypeRequest
  - `update_mask` string: The attributes (such as name etc.) you want to update for the type, specified in the parameters. For example, the update_mask=name parameter indicates that only the name will be updated in a request, any other attributes provided in your request body will be ignored.
  - `document_type` S12TypefieldV1Type: Describes the values of a type.
    - `id` string: A global unique identifier for a type.
    - `name` string: Name of the type.
    - `description` string: Description of the type.
    - `type_category` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_SYSTEM' | 'TYPE_CATEGORY_CUSTOM': - TYPE_CATEGORY_UNSPECIFIED: Type Unspecified. - TYPE_CATEGORY_SYSTEM: Type pre-defined. - TYPE_CATEGORY_CUSTOM: Type custom.
    - `domain` 'DOMAIN_UNSPECIFIED' | 'DOMAIN_GLOBAL' | 'DOMAIN_ASSETS' | 'DOMAIN_CONTRACTORS' | 'DOMAIN_LICENSES_AND_CREDENTIALS' | 'DOMAIN_TASKS' | 'DOMAIN_USERS' | 'DOMAIN_INVESTIGATIONS' | 'DOMAIN_STRUCTURES' | 'DOMAIN_INTEGRATIONS_HRIS_STAGING' | 'DOMAIN_DOCUMENTS': The domain is used to specify which domain the data is coming from. This allows the shared generic type field service to keep track of which domain owns the data, and enforce any domain-specific access control rules. - DOMAIN_UNSPECIFIED: Domain Unspecified. - DOMAIN_GLOBAL: Owned and managed by system can be used by multiple domains - DOMAIN_ASSETS: Owned and created from Assets domain - DOMAIN_CONTRACTORS: Owned and created from Contractor Management domain - DOMAIN_LICENSES_AND_CREDENTIALS: Owned and created from the Licenses and Credentials domain - DOMAIN_TASKS: Owned and created from the Tasks domain - DOMAIN_USERS: Owned and created from the Users domain - DOMAIN_INVESTIGATIONS: Owned and created from the Investigations domain - DOMAIN_STRUCTURES: Owned and created from the Organisational Structures domain - DOMAIN_INTEGRATIONS_HRIS_STAGING: Owned and created from the Integrations domain - DOMAIN_DOCUMENTS: Owned and created from the Documents service (s12.documents).
    - `stats` S12TypefieldV1TypeStats: Stats associated with a type.
      - `mapping_count` integer: The total number of mappings associated with a type.

## Response `200`

A successful response.

- S12UserdocumentsV1UpdateDocumentTypeResponse
  - `document_type` S12TypefieldV1Type: Describes the values of a type.
    - `id` string: A global unique identifier for a type.
    - `name` string: Name of the type.
    - `description` string: Description of the type.
    - `type_category` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_SYSTEM' | 'TYPE_CATEGORY_CUSTOM': - TYPE_CATEGORY_UNSPECIFIED: Type Unspecified. - TYPE_CATEGORY_SYSTEM: Type pre-defined. - TYPE_CATEGORY_CUSTOM: Type custom.
    - `domain` 'DOMAIN_UNSPECIFIED' | 'DOMAIN_GLOBAL' | 'DOMAIN_ASSETS' | 'DOMAIN_CONTRACTORS' | 'DOMAIN_LICENSES_AND_CREDENTIALS' | 'DOMAIN_TASKS' | 'DOMAIN_USERS' | 'DOMAIN_INVESTIGATIONS' | 'DOMAIN_STRUCTURES' | 'DOMAIN_INTEGRATIONS_HRIS_STAGING' | 'DOMAIN_DOCUMENTS': The domain is used to specify which domain the data is coming from. This allows the shared generic type field service to keep track of which domain owns the data, and enforce any domain-specific access control rules. - DOMAIN_UNSPECIFIED: Domain Unspecified. - DOMAIN_GLOBAL: Owned and managed by system can be used by multiple domains - DOMAIN_ASSETS: Owned and created from Assets domain - DOMAIN_CONTRACTORS: Owned and created from Contractor Management domain - DOMAIN_LICENSES_AND_CREDENTIALS: Owned and created from the Licenses and Credentials domain - DOMAIN_TASKS: Owned and created from the Tasks domain - DOMAIN_USERS: Owned and created from the Users domain - DOMAIN_INVESTIGATIONS: Owned and created from the Investigations domain - DOMAIN_STRUCTURES: Owned and created from the Organisational Structures domain - DOMAIN_INTEGRATIONS_HRIS_STAGING: Owned and created from the Integrations domain - DOMAIN_DOCUMENTS: Owned and created from the Documents service (s12.documents).
    - `stats` S12TypefieldV1TypeStats: Stats associated with a type.
      - `mapping_count` integer: The total number of mappings associated with a type.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 1 warning, 1 info
  - added the new `DOMAIN_DOCUMENTS` enum value to the `document_type/allOf[#/components/schemas/s12.typefield.v1.Type]/domain/allOf[#/components/schemas/s12.typefield.v1.Domain]/` response property for the response status `200`
  - added the new `DOMAIN_DOCUMENTS` enum value to the request property `document_type/allOf[#/components/schemas/s12.typefield.v1.Type]/domain/allOf[#/components/schemas/s12.typefield.v1.Domain]/`

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/credentials/v1/credential-type/put.md)

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
