sdkDeterministic

Publish knowledge draft

pipeline.publishKnowledgeDraft

Publish the exact reviewed knowledge draft only after explicit user approval, using the returned draft timestamp. Does not send messages or change agent autonomy.

Parameters

workspaceId
string
No description.
expectedDraftCreatedAtrequired
string
No description.

Example

TypeScripttypescript
await pipeline.publishKnowledgeDraft({
"expectedDraftCreatedAt": "2026-01-01T00:00:00.000Z"
})

Response

Success response schemajson schema
{
"type": "object",
"properties": {
"knowledge": {
"type": "object",
"properties": {
"skillId": {
"type": "string"
},
"overlayId": {
"type": [
"string",
"null"
]
},
"draft": {
"type": [
"object",
"null"
],
"properties": {
"versionNumber": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"draft",
"active",
"archived"
]
},
"changeSummary": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"activatedAt": {
"type": [
"string",
"null"
]
},
"knowledge": {
"type": "object"
}
},
"required": [
"versionNumber",
"status",
"changeSummary",
"createdAt",
"activatedAt",
"knowledge"
]
},
"published": {
"type": [
"object",
"null"
],
"properties": {
"versionNumber": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"draft",
"active",
"archived"
]
},
"changeSummary": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"activatedAt": {
"type": [
"string",
"null"
]
},
"knowledge": {
"type": "object"
}
},
"required": [
"versionNumber",
"status",
"changeSummary",
"createdAt",
"activatedAt",
"knowledge"
]
},
"versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"versionNumber": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"draft",
"active",
"archived"
]
},
"changeSummary": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"activatedAt": {
"type": [
"string",
"null"
]
},
"knowledge": {
"type": "object"
}
},
"required": [
"versionNumber",
"status",
"changeSummary",
"createdAt",
"activatedAt",
"knowledge"
]
}
}
},
"required": [
"skillId",
"overlayId",
"draft",
"published",
"versions"
]
}
},
"required": [
"knowledge"
]
}

Exceptions

PipelineError
Thrown for validation, authentication, JSON-RPC, HTTP, and network failures. Inspect code and data when present.
Pipeline TypeScript SDK documentation | Pipeline