Append Knowledge version
curl --request POST \
--url https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Cardiac Arrest - Adult (Updated)",
"description": "Updated chest-compression rate per Q1 2026 guidelines.",
"isAllCallers": false,
"externalVersion": "v1.2.0",
"publish": false,
"apiControl": {
"questions": false,
"incidentType": false,
"spokenInstructions": false,
"cadActions": false,
"smsMessages": false,
"dispatchTriggers": false,
"links": false
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": true,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": true,
"useInAssist": true,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": true,
"required": true,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": true,
"useInAssist": true,
"required": true,
"isCritical": true
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": true,
"useInAssist": true,
"required": true
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": true,
"fallbackTrigger": true
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123
}
]
}
}
EOFimport requests
url = "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions"
payload = {
"name": "Cardiac Arrest - Adult (Updated)",
"description": "Updated chest-compression rate per Q1 2026 guidelines.",
"isAllCallers": False,
"externalVersion": "v1.2.0",
"publish": False,
"apiControl": {
"questions": False,
"incidentType": False,
"spokenInstructions": False,
"cadActions": False,
"smsMessages": False,
"dispatchTriggers": False,
"links": False
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": True,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": True,
"useInAssist": True,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": True,
"required": True,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": True,
"useInAssist": True,
"required": True,
"isCritical": True
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": True,
"useInAssist": True,
"required": True
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": True,
"fallbackTrigger": True
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123
}
]
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Cardiac Arrest - Adult (Updated)',
description: 'Updated chest-compression rate per Q1 2026 guidelines.',
isAllCallers: false,
externalVersion: 'v1.2.0',
publish: false,
apiControl: {
questions: false,
incidentType: false,
spokenInstructions: false,
cadActions: false,
smsMessages: false,
dispatchTriggers: false,
links: false
},
interview: {
id: '<string>',
name: 'Cardiac Arrest - Adult',
intent: 'Caller reports an unresponsive adult with no pulse.',
service: 'MEDICAL',
isRoot: true,
disciplines: [{id: 123, name: '<string>'}],
questionList: [
{
id: 123,
referenceId: 'q-1a2b3c4d',
externalReferenceId: '<string>',
text: 'Is the patient breathing normally?',
intent: '<string>',
lowQualityCriteria: '<string>',
highQualityCriteria: '<string>',
evaluatable: true,
useInAssist: true,
displayCriteria: 'If the patient fell from something other than the ground',
isCritical: true,
required: true,
relatedQuestions: [{id: 123, displayCriteria: '<string>', questionList: '<array>'}]
}
]
},
actions: {
id: '<string>',
name: 'Cardiac Arrest - Actions',
purpose: '<string>',
disciplines: [{id: 123, name: '<string>'}],
spokenInstructions: [
{
referenceId: 'si-1a2b3c4d',
externalReferenceId: '<string>',
instruction: 'Place the heel of one hand on the center of the chest.',
sequence: 123,
conditionedOn: '<string>',
referenceMedia: '<string>',
evaluatable: true,
useInAssist: true,
required: true,
isCritical: true
}
],
cadActions: [
{
referenceId: 'ca-1a2b3c4d',
externalReferenceId: '<string>',
instruction: 'Enter call type CARDIAC.',
role: 'CALLTAKER',
conditionedOn: '<string>',
sequence: 123,
evaluatable: true,
useInAssist: true,
required: true
}
],
smsMessages: [
{
referenceId: 'sms-1a2b3c4d',
externalReferenceId: '<string>',
message: 'We\'ve dispatched help. Stay on the line.',
mediaRef: '<string>',
conditionedOn: '<string>',
sequence: 123
}
],
dispatchTriggers: [
{
referenceId: 'dt-1a2b3c4d',
externalReferenceId: '<string>',
dispatchCode: '29B',
condition: '<string>',
sequence: 123,
pinnedCode: true,
fallbackTrigger: true
}
],
media: [
{
referenceId: '<string>',
name: '<string>',
description: '<string>',
mediaType: 'IMAGE',
url: '<string>'
}
],
links: [
{
id: 123,
referenceId: 'lk-1a2b3c4d',
externalReferenceId: '<string>',
displayCriteria: '<string>',
targetExternalId: 'cpr-instructions',
targetSectionId: 123
}
]
}
})
};
fetch('https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Cardiac Arrest - Adult (Updated)',
'description' => 'Updated chest-compression rate per Q1 2026 guidelines.',
'isAllCallers' => false,
'externalVersion' => 'v1.2.0',
'publish' => false,
'apiControl' => [
'questions' => false,
'incidentType' => false,
'spokenInstructions' => false,
'cadActions' => false,
'smsMessages' => false,
'dispatchTriggers' => false,
'links' => false
],
'interview' => [
'id' => '<string>',
'name' => 'Cardiac Arrest - Adult',
'intent' => 'Caller reports an unresponsive adult with no pulse.',
'service' => 'MEDICAL',
'isRoot' => true,
'disciplines' => [
[
'id' => 123,
'name' => '<string>'
]
],
'questionList' => [
[
'id' => 123,
'referenceId' => 'q-1a2b3c4d',
'externalReferenceId' => '<string>',
'text' => 'Is the patient breathing normally?',
'intent' => '<string>',
'lowQualityCriteria' => '<string>',
'highQualityCriteria' => '<string>',
'evaluatable' => true,
'useInAssist' => true,
'displayCriteria' => 'If the patient fell from something other than the ground',
'isCritical' => true,
'required' => true,
'relatedQuestions' => [
[
'id' => 123,
'displayCriteria' => '<string>',
'questionList' => '<array>'
]
]
]
]
],
'actions' => [
'id' => '<string>',
'name' => 'Cardiac Arrest - Actions',
'purpose' => '<string>',
'disciplines' => [
[
'id' => 123,
'name' => '<string>'
]
],
'spokenInstructions' => [
[
'referenceId' => 'si-1a2b3c4d',
'externalReferenceId' => '<string>',
'instruction' => 'Place the heel of one hand on the center of the chest.',
'sequence' => 123,
'conditionedOn' => '<string>',
'referenceMedia' => '<string>',
'evaluatable' => true,
'useInAssist' => true,
'required' => true,
'isCritical' => true
]
],
'cadActions' => [
[
'referenceId' => 'ca-1a2b3c4d',
'externalReferenceId' => '<string>',
'instruction' => 'Enter call type CARDIAC.',
'role' => 'CALLTAKER',
'conditionedOn' => '<string>',
'sequence' => 123,
'evaluatable' => true,
'useInAssist' => true,
'required' => true
]
],
'smsMessages' => [
[
'referenceId' => 'sms-1a2b3c4d',
'externalReferenceId' => '<string>',
'message' => 'We\'ve dispatched help. Stay on the line.',
'mediaRef' => '<string>',
'conditionedOn' => '<string>',
'sequence' => 123
]
],
'dispatchTriggers' => [
[
'referenceId' => 'dt-1a2b3c4d',
'externalReferenceId' => '<string>',
'dispatchCode' => '29B',
'condition' => '<string>',
'sequence' => 123,
'pinnedCode' => true,
'fallbackTrigger' => true
]
],
'media' => [
[
'referenceId' => '<string>',
'name' => '<string>',
'description' => '<string>',
'mediaType' => 'IMAGE',
'url' => '<string>'
]
],
'links' => [
[
'id' => 123,
'referenceId' => 'lk-1a2b3c4d',
'externalReferenceId' => '<string>',
'displayCriteria' => '<string>',
'targetExternalId' => 'cpr-instructions',
'targetSectionId' => 123
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions"
payload := strings.NewReader("{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"version": 3,
"externalVersion": "v1.2.0",
"isPublished": true,
"description": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"apiControl": {
"questions": false,
"incidentType": false,
"spokenInstructions": false,
"cadActions": false,
"smsMessages": false,
"dispatchTriggers": false,
"links": false
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": true,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": true,
"useInAssist": true,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": true,
"required": true,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": true,
"useInAssist": true,
"required": true,
"isCritical": true
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": true,
"useInAssist": true,
"required": true
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": true,
"fallbackTrigger": true
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123,
"targetDocumentName": "<string>",
"targetKnowledgeType": "<string>",
"targetKnowledgeId": 123
}
]
}
}
Knowledge
Append Knowledge version
Add a new immutable version to an existing API-managed Knowledge entry. The version number is assigned automatically (previous + 1).
API-owned sections (where the apiControl flag was set to true on create): Send the updated content. Full-overwrite semantics apply — whatever you send becomes the new version’s content. Omitting a list, sending null, or sending [] sets that section to empty. Echo a referenceId from the previous version to update that item; omit the referenceId to add a new item. Supplying an unknown referenceId is rejected (400).
GovWorx-owned sections (where the apiControl flag was false on create): Do NOT send content for these sections. GovWorx automatically carries the previous version’s content forward. Sending content for a GovWorx-owned section is rejected (400).
Flag immutability: apiControl is set once at creation — you do not need to resend it on append. Omitting it is recommended; the stored flags are used automatically. If you do include it, each flag must match the value set on create (400 if different).
externalReferenceId: in an API-owned section it follows the full-overwrite rule — an item sent without it doesn’t have it in the new version, so echo it on every append if you use it. In a GovWorx-owned section the stored value is carried forward; an echo that adds, changes, or removes it differs from what’s stored and is rejected (400).
publish defaults to false: the new version is an unpublished draft and the previously published version stays live. Send "publish": true to publish it immediately, replacing the previously published version (or becoming the first published one if there is none).
POST
/
api
/
v1
/
external
/
knowledge
/
{knowledgeId}
/
versions
Append Knowledge version
curl --request POST \
--url https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Cardiac Arrest - Adult (Updated)",
"description": "Updated chest-compression rate per Q1 2026 guidelines.",
"isAllCallers": false,
"externalVersion": "v1.2.0",
"publish": false,
"apiControl": {
"questions": false,
"incidentType": false,
"spokenInstructions": false,
"cadActions": false,
"smsMessages": false,
"dispatchTriggers": false,
"links": false
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": true,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": true,
"useInAssist": true,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": true,
"required": true,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": true,
"useInAssist": true,
"required": true,
"isCritical": true
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": true,
"useInAssist": true,
"required": true
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": true,
"fallbackTrigger": true
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123
}
]
}
}
EOFimport requests
url = "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions"
payload = {
"name": "Cardiac Arrest - Adult (Updated)",
"description": "Updated chest-compression rate per Q1 2026 guidelines.",
"isAllCallers": False,
"externalVersion": "v1.2.0",
"publish": False,
"apiControl": {
"questions": False,
"incidentType": False,
"spokenInstructions": False,
"cadActions": False,
"smsMessages": False,
"dispatchTriggers": False,
"links": False
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": True,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": True,
"useInAssist": True,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": True,
"required": True,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": True,
"useInAssist": True,
"required": True,
"isCritical": True
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": True,
"useInAssist": True,
"required": True
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": True,
"fallbackTrigger": True
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123
}
]
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Cardiac Arrest - Adult (Updated)',
description: 'Updated chest-compression rate per Q1 2026 guidelines.',
isAllCallers: false,
externalVersion: 'v1.2.0',
publish: false,
apiControl: {
questions: false,
incidentType: false,
spokenInstructions: false,
cadActions: false,
smsMessages: false,
dispatchTriggers: false,
links: false
},
interview: {
id: '<string>',
name: 'Cardiac Arrest - Adult',
intent: 'Caller reports an unresponsive adult with no pulse.',
service: 'MEDICAL',
isRoot: true,
disciplines: [{id: 123, name: '<string>'}],
questionList: [
{
id: 123,
referenceId: 'q-1a2b3c4d',
externalReferenceId: '<string>',
text: 'Is the patient breathing normally?',
intent: '<string>',
lowQualityCriteria: '<string>',
highQualityCriteria: '<string>',
evaluatable: true,
useInAssist: true,
displayCriteria: 'If the patient fell from something other than the ground',
isCritical: true,
required: true,
relatedQuestions: [{id: 123, displayCriteria: '<string>', questionList: '<array>'}]
}
]
},
actions: {
id: '<string>',
name: 'Cardiac Arrest - Actions',
purpose: '<string>',
disciplines: [{id: 123, name: '<string>'}],
spokenInstructions: [
{
referenceId: 'si-1a2b3c4d',
externalReferenceId: '<string>',
instruction: 'Place the heel of one hand on the center of the chest.',
sequence: 123,
conditionedOn: '<string>',
referenceMedia: '<string>',
evaluatable: true,
useInAssist: true,
required: true,
isCritical: true
}
],
cadActions: [
{
referenceId: 'ca-1a2b3c4d',
externalReferenceId: '<string>',
instruction: 'Enter call type CARDIAC.',
role: 'CALLTAKER',
conditionedOn: '<string>',
sequence: 123,
evaluatable: true,
useInAssist: true,
required: true
}
],
smsMessages: [
{
referenceId: 'sms-1a2b3c4d',
externalReferenceId: '<string>',
message: 'We\'ve dispatched help. Stay on the line.',
mediaRef: '<string>',
conditionedOn: '<string>',
sequence: 123
}
],
dispatchTriggers: [
{
referenceId: 'dt-1a2b3c4d',
externalReferenceId: '<string>',
dispatchCode: '29B',
condition: '<string>',
sequence: 123,
pinnedCode: true,
fallbackTrigger: true
}
],
media: [
{
referenceId: '<string>',
name: '<string>',
description: '<string>',
mediaType: 'IMAGE',
url: '<string>'
}
],
links: [
{
id: 123,
referenceId: 'lk-1a2b3c4d',
externalReferenceId: '<string>',
displayCriteria: '<string>',
targetExternalId: 'cpr-instructions',
targetSectionId: 123
}
]
}
})
};
fetch('https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Cardiac Arrest - Adult (Updated)',
'description' => 'Updated chest-compression rate per Q1 2026 guidelines.',
'isAllCallers' => false,
'externalVersion' => 'v1.2.0',
'publish' => false,
'apiControl' => [
'questions' => false,
'incidentType' => false,
'spokenInstructions' => false,
'cadActions' => false,
'smsMessages' => false,
'dispatchTriggers' => false,
'links' => false
],
'interview' => [
'id' => '<string>',
'name' => 'Cardiac Arrest - Adult',
'intent' => 'Caller reports an unresponsive adult with no pulse.',
'service' => 'MEDICAL',
'isRoot' => true,
'disciplines' => [
[
'id' => 123,
'name' => '<string>'
]
],
'questionList' => [
[
'id' => 123,
'referenceId' => 'q-1a2b3c4d',
'externalReferenceId' => '<string>',
'text' => 'Is the patient breathing normally?',
'intent' => '<string>',
'lowQualityCriteria' => '<string>',
'highQualityCriteria' => '<string>',
'evaluatable' => true,
'useInAssist' => true,
'displayCriteria' => 'If the patient fell from something other than the ground',
'isCritical' => true,
'required' => true,
'relatedQuestions' => [
[
'id' => 123,
'displayCriteria' => '<string>',
'questionList' => '<array>'
]
]
]
]
],
'actions' => [
'id' => '<string>',
'name' => 'Cardiac Arrest - Actions',
'purpose' => '<string>',
'disciplines' => [
[
'id' => 123,
'name' => '<string>'
]
],
'spokenInstructions' => [
[
'referenceId' => 'si-1a2b3c4d',
'externalReferenceId' => '<string>',
'instruction' => 'Place the heel of one hand on the center of the chest.',
'sequence' => 123,
'conditionedOn' => '<string>',
'referenceMedia' => '<string>',
'evaluatable' => true,
'useInAssist' => true,
'required' => true,
'isCritical' => true
]
],
'cadActions' => [
[
'referenceId' => 'ca-1a2b3c4d',
'externalReferenceId' => '<string>',
'instruction' => 'Enter call type CARDIAC.',
'role' => 'CALLTAKER',
'conditionedOn' => '<string>',
'sequence' => 123,
'evaluatable' => true,
'useInAssist' => true,
'required' => true
]
],
'smsMessages' => [
[
'referenceId' => 'sms-1a2b3c4d',
'externalReferenceId' => '<string>',
'message' => 'We\'ve dispatched help. Stay on the line.',
'mediaRef' => '<string>',
'conditionedOn' => '<string>',
'sequence' => 123
]
],
'dispatchTriggers' => [
[
'referenceId' => 'dt-1a2b3c4d',
'externalReferenceId' => '<string>',
'dispatchCode' => '29B',
'condition' => '<string>',
'sequence' => 123,
'pinnedCode' => true,
'fallbackTrigger' => true
]
],
'media' => [
[
'referenceId' => '<string>',
'name' => '<string>',
'description' => '<string>',
'mediaType' => 'IMAGE',
'url' => '<string>'
]
],
'links' => [
[
'id' => 123,
'referenceId' => 'lk-1a2b3c4d',
'externalReferenceId' => '<string>',
'displayCriteria' => '<string>',
'targetExternalId' => 'cpr-instructions',
'targetSectionId' => 123
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions"
payload := strings.NewReader("{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govworx.net/api/v1/external/knowledge/{knowledgeId}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Cardiac Arrest - Adult (Updated)\",\n \"description\": \"Updated chest-compression rate per Q1 2026 guidelines.\",\n \"isAllCallers\": false,\n \"externalVersion\": \"v1.2.0\",\n \"publish\": false,\n \"apiControl\": {\n \"questions\": false,\n \"incidentType\": false,\n \"spokenInstructions\": false,\n \"cadActions\": false,\n \"smsMessages\": false,\n \"dispatchTriggers\": false,\n \"links\": false\n },\n \"interview\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Adult\",\n \"intent\": \"Caller reports an unresponsive adult with no pulse.\",\n \"service\": \"MEDICAL\",\n \"isRoot\": true,\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"questionList\": [\n {\n \"id\": 123,\n \"referenceId\": \"q-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"text\": \"Is the patient breathing normally?\",\n \"intent\": \"<string>\",\n \"lowQualityCriteria\": \"<string>\",\n \"highQualityCriteria\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"displayCriteria\": \"If the patient fell from something other than the ground\",\n \"isCritical\": true,\n \"required\": true,\n \"relatedQuestions\": [\n {\n \"id\": 123,\n \"displayCriteria\": \"<string>\",\n \"questionList\": \"<array>\"\n }\n ]\n }\n ]\n },\n \"actions\": {\n \"id\": \"<string>\",\n \"name\": \"Cardiac Arrest - Actions\",\n \"purpose\": \"<string>\",\n \"disciplines\": [\n {\n \"id\": 123,\n \"name\": \"<string>\"\n }\n ],\n \"spokenInstructions\": [\n {\n \"referenceId\": \"si-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Place the heel of one hand on the center of the chest.\",\n \"sequence\": 123,\n \"conditionedOn\": \"<string>\",\n \"referenceMedia\": \"<string>\",\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true,\n \"isCritical\": true\n }\n ],\n \"cadActions\": [\n {\n \"referenceId\": \"ca-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"instruction\": \"Enter call type CARDIAC.\",\n \"role\": \"CALLTAKER\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123,\n \"evaluatable\": true,\n \"useInAssist\": true,\n \"required\": true\n }\n ],\n \"smsMessages\": [\n {\n \"referenceId\": \"sms-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"message\": \"We've dispatched help. Stay on the line.\",\n \"mediaRef\": \"<string>\",\n \"conditionedOn\": \"<string>\",\n \"sequence\": 123\n }\n ],\n \"dispatchTriggers\": [\n {\n \"referenceId\": \"dt-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"dispatchCode\": \"29B\",\n \"condition\": \"<string>\",\n \"sequence\": 123,\n \"pinnedCode\": true,\n \"fallbackTrigger\": true\n }\n ],\n \"media\": [\n {\n \"referenceId\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"mediaType\": \"IMAGE\",\n \"url\": \"<string>\"\n }\n ],\n \"links\": [\n {\n \"id\": 123,\n \"referenceId\": \"lk-1a2b3c4d\",\n \"externalReferenceId\": \"<string>\",\n \"displayCriteria\": \"<string>\",\n \"targetExternalId\": \"cpr-instructions\",\n \"targetSectionId\": 123\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"version": 3,
"externalVersion": "v1.2.0",
"isPublished": true,
"description": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"apiControl": {
"questions": false,
"incidentType": false,
"spokenInstructions": false,
"cadActions": false,
"smsMessages": false,
"dispatchTriggers": false,
"links": false
},
"interview": {
"id": "<string>",
"name": "Cardiac Arrest - Adult",
"intent": "Caller reports an unresponsive adult with no pulse.",
"service": "MEDICAL",
"isRoot": true,
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"questionList": [
{
"id": 123,
"referenceId": "q-1a2b3c4d",
"externalReferenceId": "<string>",
"text": "Is the patient breathing normally?",
"intent": "<string>",
"lowQualityCriteria": "<string>",
"highQualityCriteria": "<string>",
"evaluatable": true,
"useInAssist": true,
"displayCriteria": "If the patient fell from something other than the ground",
"isCritical": true,
"required": true,
"relatedQuestions": [
{
"id": 123,
"displayCriteria": "<string>",
"questionList": "<array>"
}
]
}
]
},
"actions": {
"id": "<string>",
"name": "Cardiac Arrest - Actions",
"purpose": "<string>",
"disciplines": [
{
"id": 123,
"name": "<string>"
}
],
"spokenInstructions": [
{
"referenceId": "si-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Place the heel of one hand on the center of the chest.",
"sequence": 123,
"conditionedOn": "<string>",
"referenceMedia": "<string>",
"evaluatable": true,
"useInAssist": true,
"required": true,
"isCritical": true
}
],
"cadActions": [
{
"referenceId": "ca-1a2b3c4d",
"externalReferenceId": "<string>",
"instruction": "Enter call type CARDIAC.",
"role": "CALLTAKER",
"conditionedOn": "<string>",
"sequence": 123,
"evaluatable": true,
"useInAssist": true,
"required": true
}
],
"smsMessages": [
{
"referenceId": "sms-1a2b3c4d",
"externalReferenceId": "<string>",
"message": "We've dispatched help. Stay on the line.",
"mediaRef": "<string>",
"conditionedOn": "<string>",
"sequence": 123
}
],
"dispatchTriggers": [
{
"referenceId": "dt-1a2b3c4d",
"externalReferenceId": "<string>",
"dispatchCode": "29B",
"condition": "<string>",
"sequence": 123,
"pinnedCode": true,
"fallbackTrigger": true
}
],
"media": [
{
"referenceId": "<string>",
"name": "<string>",
"description": "<string>",
"mediaType": "IMAGE",
"url": "<string>"
}
],
"links": [
{
"id": 123,
"referenceId": "lk-1a2b3c4d",
"externalReferenceId": "<string>",
"displayCriteria": "<string>",
"targetExternalId": "cpr-instructions",
"targetSectionId": 123,
"targetDocumentName": "<string>",
"targetKnowledgeType": "<string>",
"targetKnowledgeId": 123
}
]
}
}
Path Parameters
GovWorx internal Knowledge id returned from the create endpoint.
Body
application/json
Append a new immutable version to an existing Knowledge entry. Provide at least one of interview or actions.
Optional updated name for the Knowledge entry. When supplied, replaces the existing name.
Maximum string length:
255Example:
"Cardiac Arrest - Adult (Updated)"
Optional description. When supplied, updates both the Knowledge entry's top-level description and the new version's description. When omitted, the Knowledge description is unchanged and the version description defaults to 'Appended via external API'.
Example:
"Updated chest-compression rate per Q1 2026 guidelines."
If true, marks this entry as the tenant's all-callers guide card (single per tenant). Omit to leave the existing value unchanged.
Optional partner-supplied version label. Free-form short string; stored but not used for ordering or lookup.
Maximum string length:
64Example:
"v1.2.0"
If true, publishes the new version immediately, replacing the previously published version. Defaults to false: the new version is an unpublished draft and the previously published version stays live.
Optional. Ownership flags are set once at creation and are immutable — you do not need to resend them on every append. If omitted (recommended), the stored flags are used automatically. If supplied, each provided flag must match the value set on create (400 if different). To change ownership, delete the entry and recreate it.
Show child attributes
Show child attributes
Interview content for the new version. API-owned questions (apiControl.questions = true): Send the full questionList. Echo a referenceId to update an existing question; omit it to add a new one. Unknown ids → 400. Omitting / null / [] results in an empty question list (full overwrite). Each question's externalReferenceId follows the same rule — echo it to keep it, omit it to drop it. GovWorx-owned questions (apiControl.questions = false): it is carried forward automatically regardless of what's sent. Omitting questionList, sending it null or [], or echoing it back unchanged are all accepted and ignored. A value that differs from what's stored is rejected (400), including an echo that adds, changes, or removes an externalReferenceId.
Show child attributes
Show child attributes
Action set content for the new version. For each API-owned sub-section (flag = true): send the updated list; echo a referenceId to update, omit to add new. Omit / null / [] = empty (full overwrite). Each item's externalReferenceId follows the same rule — echo it to keep it, omit it to drop it. For each GovWorx-owned sub-section (flag = false): it is carried forward automatically regardless of what's sent. Omitting that list, sending it null or [], or echoing it back unchanged are all accepted and ignored. A value that differs from what's stored is rejected (400), including an echo that adds, changes, or removes an externalReferenceId.
Show child attributes
Show child attributes
Response
Version appended. Response includes the full new version with all GovWorx-generated referenceIds.
Full detail of a Knowledge version, including its normalized interview and action content. All referenceId values in the returned content are GovWorx-generated stable identifiers. Store these ids — they must be echoed in future append requests to update existing items in place.
Monotonic version number, unique per Knowledge id. Use this in version-scoped routes.
Example:
3
Optional partner-supplied version label.
Example:
"v1.2.0"
True if this version is the currently published version for the Knowledge entry.
Optional description of this version, as provided on create or append.
UTC timestamp when this version was created (i.e., when GovWorx received and stored the payload).
UTC timestamp when this version was last published (made active), or null if never published.
The active API ownership flags for this version. Echoes what was declared on create and is immutable between versions. Use this to confirm which sections are API-controlled vs GovWorx-controlled.
Show child attributes
Show child attributes
Interview (question list) content for this version with all GovWorx-generated referenceIds populated. Null if this knowledge type does not carry interview content.
Show child attributes
Show child attributes
Action set content for this version with all GovWorx-generated referenceIds populated across spoken instructions (si-), CAD actions (ca-), SMS messages (sms-), and dispatch triggers (dt-). Null if no action content exists for this version.
Show child attributes
Show child attributes
⌘I