> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangrovesystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a model version label

> Sets the version label on one model version. Send `null` or an empty string to clear it. The `version_label` key is required, so a request without it returns `400` and leaves the stored value as it is.



## OpenAPI

````yaml PATCH /models/{model_id}/version_label
openapi: 3.1.0
info:
  title: Mangrove - API
  version: 1.1.0
servers:
  - url: https://app.gomangrove.com/api/v1
security:
  - sec0: []
paths:
  /models/{model_id}/version_label:
    patch:
      summary: Update a model version label
      description: >-
        Sets the version label on one model version. Send `null` or an empty
        string to clear it. The `version_label` key is required, so a request
        without it returns `400` and leaves the stored value as it is.
      operationId: update-model-version-label
      parameters:
        - name: model_id
          in: path
          description: Model friendly ID (e.g., mod_abc123def456)
          schema:
            type: string
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              properties:
                model:
                  type: object
                  required:
                    - version_label
                  properties:
                    version_label:
                      type: string
                      nullable: true
                      description: >-
                        Up to 255 characters (letters, numbers, spaces and `_ -
                        . ( ) /`).
            examples:
              Result:
                value:
                  model:
                    version_label: Measured density
      responses:
        '200':
          description: The updated model.
          content:
            application/json:
              examples:
                Result:
                  value:
                    id: mod_abc123def456
                    name: Carbon Calculation Model
                    version: 1
                    version_label: Measured density
                    description: null
                    is_latest: true
                    cadence: monthly
                    partition_type: feedstock
                    order: 1
                    created_at: '2025-01-15T10:00:00.000Z'
                    updated_at: '2025-01-15T12:00:00.000Z'
                    ui_url: >-
                      https://app.gomangrove.com/nexus/prj_AbCd1234567890Ef/system/mod_abc123def456
              schema:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                  version:
                    type: integer
                  version_label:
                    type: string
                    nullable: true
                    description: >-
                      A short name for the version, up to 255 characters
                      (letters, numbers, spaces and `_ - . ( ) /`).
                  description:
                    type: string
                    nullable: true
                    description: What changed in the version, up to 500 characters.
                  is_latest:
                    type: boolean
                  cadence:
                    type: string
                  partition_type:
                    type: string
                    description: >-
                      Batch partition strategy: time, feedstock, tracking_id,
                      asset, tracking_id_and_feedstock, or
                      tracking_id_and_asset. The two composite strategies
                      partition by both dimensions at once.
                  order:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  ui_url:
                    type: string
                    nullable: true
                    description: >-
                      Link that opens this model in the Mangrove app. Null when
                      the model has no project.
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value:
                    errors:
                      - message: version_label is required
        '422':
          description: '422'
          content:
            application/json:
              examples:
                Result:
                  value:
                    errors:
                      - message: Version label contains invalid characters
                        field: version_label
                        code: invalid
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: ''

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.