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

# Edit Release Channel

> Update the target app version or name of an existing app release channel



## OpenAPI

````yaml Patch /v1/apps/{packageName}/release-channels/{releaseChannelId}
openapi: 3.1.0
info:
  title: ManageXR API
  description: API documentation for ManageXR
  version: 1.0.0
servers:
  - url: https://managexrapi.com
    description: ManageXR API Server
security:
  - basicAuth: []
paths:
  /v1/apps/{packageName}/release-channels/{releaseChannelId}:
    patch:
      summary: Edit a release channel
      description: Update the target app version or name of an existing app release channel
      parameters:
        - name: packageName
          in: path
          required: true
          schema:
            type: string
          description: The package name of the app
        - name: releaseChannelId
          in: path
          required: true
          schema:
            type: string
          description: The unique identifier of the release channel
        - name: organizationId
          in: query
          required: false
          schema:
            type: string
          description: >
            Unique identifier of the organization. This parameter is only
            necessary when using multi-organization API keys. 


            Defaults to the organizationId associated with the API key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: New name for the release channel
                  example: Production
                targetVersion:
                  oneOf:
                    - type: object
                      properties:
                        versionCode:
                          type: number
                          description: Version code of the app
                          example: 42
                        versionName:
                          type: string
                          description: Version name of the app
                          example: 1.0.0
                        versionLabel:
                          type: string
                          description: Label for uniqueness among app versions
                          example: Quest
                    - type: string
                      enum:
                        - latest
                        - last-created
                      description: >-
                        Special version identifier. "latest" = latest semver
                        version. "last-created" = most recently created on
                        ManageXR.
                      example: latest
                    - type: string
                      description: App version ID
                      example: av_123
            examples:
              example-name-only:
                summary: Update only the release channel name
                value:
                  name: Stable
              example-latest:
                summary: Update to the latest version
                value:
                  targetVersion: latest
              example-last-created:
                summary: Update to the most recently created version
                value:
                  targetVersion: last-created
              example-specific-version:
                summary: Update to a specific version with version code and name
                value:
                  targetVersion:
                    versionCode: 42
                    versionName: 1.0.0
              example-specific-version-with-label:
                summary: >-
                  Update to a specific version with version code, name, and
                  label
                value:
                  targetVersion:
                    versionCode: 42
                    versionName: 1.0.0
                    versionLabel: Release
              example-app-id:
                summary: Update to a specific version using app version ID
                value:
                  targetVersion: av_123
              example-name-and-version:
                summary: Update both name and version
                value:
                  name: Stable
                  targetVersion: latest
      responses:
        '200':
          description: The updated release channel
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Unique identifier of the release channel
                        example: rc_123
                      name:
                        type: string
                        description: Name of the release channel
                        example: Stable
                      type:
                        type: string
                        enum:
                          - app
                          - link
                          - video
                        description: Type of the release channel
                        example: app
                      packageName:
                        type: string
                        description: Package name of the app
                        example: com.example.app
                      targetVersion:
                        type: object
                        description: The target app version for this release channel
                        properties:
                          id:
                            type: string
                            description: Unique identifier of the app version
                            example: av_123
                          type:
                            type: string
                            enum:
                              - managed
                              - shared
                              - external
                              - instant
                            description: Type of the app version
                            example: managed
                          configurationDeployments:
                            type: object
                            description: >-
                              Map of configuration ID to device count using
                              application
                            example:
                              config_123: 1
                              config_456: 0
                          createdAt:
                            type: number
                            description: Creation timestamp
                            example: 1645615777448
                          updatedAt:
                            type: number
                            description: Last update timestamp
                            example: 1687352117203
                          versionCode:
                            type: number
                            description: Version code of the app
                            example: 83894522
                          versionName:
                            type: string
                            description: Version name of the app
                            example: 8.7.8.1206
                      apkSize:
                        type: number
                        description: Size of the APK file in bytes
                        example: 72633861
                      selfHosted:
                        type: boolean
                        description: Whether the app is self-hosted
                        example: false
                      sharedOrganizations:
                        type: array
                        description: >-
                          List of organizations this release channel is shared
                          with
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the organization
                              example: org_789
                            name:
                              type: string
                              description: Name of the organization
                              example: Example Org
              example:
                data:
                  id: rc_123
                  name: Stable
                  type: app
                  packageName: com.example.app
                  targetVersion:
                    id: av_123
                    type: managed
                    configurationDeployments:
                      config_123: 1
                      config_456: 0
                    createdAt: 1645615777448
                    updatedAt: 1687352117203
                    versionCode: 83894522
                    versionName: 8.7.8.1206
                    selfHosted: false
                  sharedOrganizations:
                    - id: org_789
                      name: Example Org
        '400':
          description: Release channel package name mismatch
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: >-
                      Release channel with id rc_123 does not match the provided
                      package name com.example.app
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 400
                message: >-
                  Release channel with id rc_123 does not match the provided
                  package name com.example.app
                error: ManageXR Error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 403
                  message:
                    type: string
                    example: Forbidden
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 403
                message: Forbidden
                error: ManageXR Error
        '404':
          description: Release channel not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 404
                  message:
                    type: string
                    example: Release channel with id rc_123 not found
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 404
                message: Release channel with id rc_123 not found
                error: ManageXR Error
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >
        API key based authentication where <encoded-value> is the Base64
        encoding of `API_KEY_ID`:`API_KEY_SECRET`

        - **Username**: The API Key ID.

        - **Password**: The API Key Secret.

````