Instruction

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vulk-dev/json-schema/vulk-dev-instruction-schema.json",
  "title": "Instruction",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vulk-dev-openapi.json#/components/schemas/Instruction",
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000,
      "description": "The brief, or the next instruction, in any language. It is handed to VULK unchanged."
    },
    "model": {
      "type": "string",
      "description": "A model id from GET /models, or `auto`. Omit it to let VULK choose. A model your plan does not include answers 402."
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "description": "A UUID v4 you make. Send the same requestId to retry a submit whose answer was lost: the API returns the operation it already created instead of starting a second one. Omitted, VULK makes one."
    }
  },
  "required": [
    "prompt"
  ]
}