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

# Fetch this VM's immutable launch payload

> Requires the vendor-verified identity of an active run. Returns only that run's encrypted-at-rest scheduler snapshot, including the rendered prompt and harness or code context. No application scope is required. Sessions, API keys, OAuth clients, other runs and terminal runs cannot retrieve it. Responses are never cached.

Requires vendor-verified run identity; sessions and other bearer tokens cannot call this operation.



## OpenAPI

````yaml /openapi.yaml get /api/v1/runtime-launch
openapi: 3.1.0
info:
  title: Factorize API
  version: 1.0.0
  description: >-
    Versioned Factorize REST API. See the hosted docs for examples and OAuth
    discovery.
  x-dashboard-auth: >-
    Access-token and authorized-client management and trace replay operations
    require an interactive owner session; all other operations accept a suitably
    scoped bearer token or owner session.
servers:
  - url: https://app.factorize.sh
security:
  - bearerAuth: []
paths:
  /api/v1/runtime-launch:
    get:
      tags:
        - runtime-launch
      summary: Fetch this VM's immutable launch payload
      description: >-
        Requires the vendor-verified identity of an active run. Returns only
        that run's encrypted-at-rest scheduler snapshot, including the rendered
        prompt and harness or code context. No application scope is required.
        Sessions, API keys, OAuth clients, other runs and terminal runs cannot
        retrieve it. Responses are never cached.


        Requires vendor-verified run identity; sessions and other bearer tokens
        cannot call this operation.
      operationId: get_api_v1_runtime_launch
      responses:
        '200':
          description: Launch payload for the calling run
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      version:
                        type: number
                        const: 1
                      runId:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                      traceSources:
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                      prompt:
                        type: string
                      skillFiles:
                        type: array
                        items:
                          type: object
                          properties:
                            path:
                              type: string
                              minLength: 1
                              maxLength: 1024
                            content:
                              type: string
                            executable:
                              type: boolean
                          required:
                            - path
                            - content
                            - executable
                          additionalProperties: false
                      harness:
                        type: object
                        properties:
                          executable:
                            type: string
                            minLength: 1
                          args:
                            type: array
                            items:
                              type: string
                          env:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties:
                              type: string
                        required:
                          - executable
                          - args
                          - env
                        additionalProperties: false
                    required:
                      - version
                      - runId
                      - prompt
                      - harness
                    additionalProperties: false
                  - type: object
                    properties:
                      version:
                        type: number
                        const: 1
                      runId:
                        type: string
                        format: uuid
                        pattern: >-
                          ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
                      traceSources:
                        type: object
                        propertyNames:
                          type: string
                        additionalProperties: {}
                      code:
                        type: object
                        properties:
                          script:
                            type: string
                          context:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties: {}
                        required:
                          - script
                          - context
                        additionalProperties: false
                    required:
                      - version
                      - runId
                      - code
                    additionalProperties: false
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '409':
          $ref: '#/components/responses/Error409'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '503':
          $ref: '#/components/responses/Error503'
      security:
        - vendorRunIdentity: []
          runIdentityHeader: []
components:
  responses:
    Error400:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error401:
      description: Invalid or revoked credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error403:
      description: Missing scope or required owner session
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error409:
      description: Operation conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error429:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error500:
      description: Internal error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error503:
      description: Service unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
    vendorRunIdentity:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Fresh vendor-signed exe.dev WIF or Fly Machine OIDC token matching the
        provisioned active run. Must be combined with X-Factorize-Run-Id; a
        vendor token alone grants no access.
    runIdentityHeader:
      type: apiKey
      in: header
      name: X-Factorize-Run-Id
      description: >-
        Provisioned run UUID. Used only to locate the immutable vendor/VM
        binding; this header is not a credential. Scopes and tenant come from
        the server-side run snapshot.

````

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