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

# Queue an administrative upgrade



## OpenAPI

````yaml /docs/service-api.yaml post /services/{service}/upgrades
openapi: 3.1.0
info:
  title: Spartan Service API
  version: 1.1.0
  description: >-
    Service inventory, lifecycle, billing, pricing, notes, members, addons,
    provider service details, upgrades, downgrades, and evidence. All operations
    require a bearer API token with the documented `x-permission`.
servers:
  - url: https:/docs.dezerx.com/api/application
    description: Development
security:
  - bearerAuth: []
tags:
  - name: Services
  - name: Lifecycle
  - name: Billing
  - name: Members
  - name: Service Details
  - name: Evidence
paths:
  /services/{service}/upgrades:
    post:
      tags:
        - Billing
      summary: Queue an administrative upgrade
      parameters:
        - $ref: '#/components/parameters/ServiceId'
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        $ref: '#/components/requestBodies/ProductChange'
      responses:
        '202':
          $ref: '#/components/responses/Async'
components:
  parameters:
    ServiceId:
      name: service
      in: path
      required: true
      schema:
        type: integer
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      schema:
        type: string
        maxLength: 255
  requestBodies:
    ProductChange:
      content:
        application/json:
          schema:
            type: object
            required:
              - new_product_id
            properties:
              new_product_id:
                type: integer
  responses:
    Async:
      description: Operation accepted and queued
      content:
        application/json:
          schema:
            type: object
            required:
              - data
              - meta
            properties:
              data:
                type: object
                properties:
                  service_id:
                    type: integer
                  invoice_id:
                    type: integer
                  job:
                    type: string
              message:
                type: string
              meta:
                type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````