kifas.workflow.publish
kifas.workflow.publish
Section titled “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
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workflow_id |
string |
yes | — | |
expected_draft_version |
string |
no | — | |
changelog |
string |
no | — |
Returns
Section titled “Returns”{ "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}Code samples
Section titled “Code samples”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 osimport 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
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" } }}Try it
Section titled “Try it”Want to try kifas.workflow.publish? Sign in to the dashboard and run it against a real session.