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

# Start a ConvertSuite job

> Requires the `convertsuite:process` scope and a unique `Idempotency-Key` header. The job is queued for processing.



## OpenAPI

````yaml /openapi.json post /v1/convertsuite/jobs/{jobId}/start
openapi: 3.1.0
info:
  title: KmerHosting API
  version: v1
  description: >-
    Public API for resources owned by the authenticated KmerHosting account.
    Sensitive infrastructure operations require an explicit scope, an IPv4
    allowlist and an idempotency key. Provider credentials, purchases and
    account administration remain unavailable.
servers:
  - url: https://api.kmerhosting.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
  - name: Services
  - name: Domains
  - name: Email Hosting
  - name: Shared Hosting
  - name: LXC
  - name: KVM
  - name: ConvertSuite
paths:
  /v1/convertsuite/jobs/{jobId}/start:
    post:
      tags:
        - ConvertSuite
      summary: Start a ConvertSuite job
      description: >-
        Requires the `convertsuite:process` scope and a unique `Idempotency-Key`
        header. The job is queued for processing.
      operationId: post_v1_convertsuite_jobs_jobId_start
      parameters:
        - in: path
          name: jobId
          required: true
          schema:
            type: string
            format: uuid
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
      responses:
        '200':
          description: ConvertSuite response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '201':
          description: ConvertSuite response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '202':
          description: ConvertSuite response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '402':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '409':
          $ref: '#/components/responses/Error'
components:
  parameters:
    IdempotencyKey:
      in: header
      name: Idempotency-Key
      required: true
      schema:
        type: string
        minLength: 8
        maxLength: 128
        pattern: ^[A-Za-z0-9._:-]+$
  schemas:
    Envelope:
      type: object
      required:
        - data
        - request_id
      properties:
        data: {}
        request_id:
          type: string
          format: uuid
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
              format: uuid
  responses:
    Error:
      description: API error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: KMERHOSTING_API_KEY or OAuth access token
      description: >-
        `Authorization: Bearer kh_live_...` or a user-scoped `kh_oauth_...`
        token.

````