> ## 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.

# Get a ConvertSuite job

> Requires `convertsuite:read`. Includes short-lived signed artifact download URLs when available.



## OpenAPI

````yaml /openapi.json get /v1/convertsuite/jobs/{jobId}
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}:
    get:
      tags:
        - ConvertSuite
      summary: Get a ConvertSuite job
      description: >-
        Requires `convertsuite:read`. Includes short-lived signed artifact
        download URLs when available.
      operationId: get_v1_convertsuite_jobs_jobId
      parameters:
        - in: path
          name: jobId
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: ConvertSuite response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
components:
  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.

````