Docs
API 1.39
Status
Objects

ProgramVersion

The ProgramVersion object of the Kaabist API.

FieldTypeRequiredDescription
idstringyespattern ^pv_[0-9a-hjkmnp-tv-z]{26}$
object"program_version"yes
program_idstringyespattern ^prg_[0-9a-hjkmnp-tv-z]{26}$
versionintegeryes≥ 1
status"draft", "published", "archived"yes
definitionProgramDefinitionyes
definition_hashstringyes
lintLintResultyes
notesstring or nullyes
source"manual", "api", "proposal", "takeover"yes
created_atstring (date-time)yes
published_atstring or null (date-time)yes

#Example

{
  "id": "pv_01j9zqk3q7m4n5p6r7s8t9v0wx",
  "object": "program_version",
  "program_id": "prg_01j9zqk3q7m4n5p6r7s8t9v0wx",
  "version": 3,
  "status": "published",
  "definition": {
    "kaab": "1",
    "steps": [
      {
        "goto": "https://shop.example.com/p/1"
      },
      {
        "extract": {
          "title": "h1"
        }
      }
    ]
  },
  "definition_hash": "sha256:9ab1",
  "lint": {
    "errors": [],
    "warnings": [
      {
        "code": "W001",
        "path": "steps[0]",
        "message": "`goto` without `expect`"
      }
    ]
  },
  "notes": "healing: relocate price",
  "source": "proposal",
  "created_at": "2026-09-18T10:00:00Z",
  "published_at": "2026-09-18T10:00:00Z"
}

Was this page helpful?