Skip to content

kifas.workflow.publish

Publish the unpublished changes (the draft) of a workflow. A browser test is never published on trust: this starts a fresh validation run of the draft from a clean session and returns validation_run_id with status validating — the draft is published automatically only if that run passes. That validation run is billed to the account as ordinary browser minutes, and is refused when the account is out of credits. A mobile test has no automatic validation, so it publishes immediately as user-verified and returns the new semver. Until a draft is published, schedules, CI, the API and suites keep running the previously published version.

Required scopes: workflow:write

Name Type Required Default Description
workflow_id string yes —
expected_draft_version string no —
changelog string no —
{
"type": "object",
"properties": {
"workflow_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"status": {
"type": "string",
"enum": [
"validating",
"published"
]
},
"draft_version": {
"type": "string"
},
"validation_run_id": {
"type": [
"string",
"null"
]
},
"semver": {
"type": [
"string",
"null"
]
},
"previous_semver": {
"type": [
"string",
"null"
]
},
"workflow_version_id": {
"type": [
"string",
"null"
]
}
},
"required": [
"workflow_id",
"status",
"draft_version",
"validation_run_id",
"semver",
"previous_semver",
"workflow_version_id"
],
"additionalProperties": false
}
TypeScript (Anthropic MCP SDK)
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamable-http.js'
const transport = new StreamableHTTPClientTransport(
new URL('https://mcp.kifas.io/'),
{
requestInit: {
headers: { Authorization: `Bearer ${process.env.KIFAS_API_KEY}` },
},
},
)
const client = new Client({ name: 'demo', version: '0.1.0' })
await client.connect(transport)
const result = await client.callTool({
name: 'kifas.workflow.publish',
arguments: {
"workflow_id": "00000000-0000-0000-0000-000000000000"
},
})
console.log(result)
Python (httpx, raw JSON-RPC)
import os
import httpx
resp = httpx.post(
"https://mcp.kifas.io/",
headers={
"Authorization": f"Bearer {os.environ['KIFAS_API_KEY']}",
"Content-Type": "application/json",
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kifas.workflow.publish",
"arguments": {
"workflow_id": "00000000-0000-0000-0000-000000000000"
},
},
},
)
print(resp.json())
curl
Terminal window
curl https://mcp.kifas.io/ \
-H "Authorization: Bearer $KIFAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kifas.workflow.publish",
"arguments": {
"workflow_id": "00000000-0000-0000-0000-000000000000"
}
}
}'
Raw JSON-RPC body
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kifas.workflow.publish",
"arguments": {
"workflow_id": "00000000-0000-0000-0000-000000000000"
}
}
}

Want to try kifas.workflow.publish? Sign in to the dashboard and run it against a real session.

Try in Kifas →