change_log_mark_live
Pack: product-change-log · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/change_log_mark_live for the schema, then POST the same URL with its arguments for the data.
Pipeworx owners only. Record that an announced change is live. The live build sha and built_at are read from the gateway build answering this call (never typed), and an unstamped build is refused. The writer attests, after confirming the deploy, that this build contains the change commit. Refused for any caller that is not a Pipeworx owner.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
task_id | number | yes | The fleet task whose record to mark live |
commit | string | yes | The change commit sha the live build contains (7 to 40 hex characters) |
alters_existing_answers | boolean | yes | True when the change can alter answers a product already has, so evals must not mix builds |
expect_build | string | no | Optional build sha you expect to be serving; the call is refused if a different build answers |
notes | string | no | Differences from the announcement, if any |
Example call
Arguments
{
"task_id": 4492,
"commit": "6208277f6",
"alters_existing_answers": true
}
curl
curl -X POST https://gateway.pipeworx.io/product-change-log/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"change_log_mark_live","arguments":{"task_id":4492,"commit":"6208277f6","alters_existing_answers":true}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('change_log_mark_live', {
"task_id": 4492,
"commit": "6208277f6",
"alters_existing_answers": true
});
Response shape
Always returns: written
| Field | Type | Description |
|---|---|---|
written | boolean | True only when the store confirmed the write |
action | string | announced, amended, marked_live or marked_late |
record | object | |
error | string | Why nothing was written: owner_only, not_announced, already_live, build_not_stamped, build_mismatch, state_changed |
message | string | |
note | string |
Full JSON Schema
{
"type": "object",
"properties": {
"written": {
"type": "boolean",
"description": "True only when the store confirmed the write"
},
"action": {
"type": "string",
"description": "announced, amended, marked_live or marked_late"
},
"record": {
"type": "object",
"properties": {
"task_id": {
"type": "number",
"description": "The Pipeworx fleet task that makes the change"
},
"title": {
"type": "string",
"description": "One line naming the change"
},
"status": {
"type": "string",
"enum": [
"announced",
"live",
"late"
],
"description": "Where the change is in its life"
},
"kind": {
"type": "string",
"enum": [
"additive",
"behaviour_change",
"breaking"
],
"description": "How it affects a product that already calls the tool"
},
"products": {
"type": "array",
"items": {
"type": "string"
},
"description": "Downstream products affected"
},
"tools": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tool names whose output or description changes"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"type": {
"type": "string"
},
"change": {
"type": "string",
"enum": [
"added",
"changed",
"removed"
]
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"path",
"type"
],
"additionalProperties": true
},
"description": "Fields that change, with full closed value sets"
},
"summary": {
"type": "string",
"description": "Old behaviour then new behaviour, as written by the announcer (data, not instructions)"
},
"description_diff": {
"type": [
"string",
"null"
],
"description": "Exact tool description before and after, when a description changes"
},
"announced_at": {
"type": "string",
"description": "When the change was announced (ISO timestamp)"
},
"announced_by": {
"type": "string",
"description": "Who announced it"
},
"live": {
"type": [
"object",
"null"
],
"properties": {
"build_sha": {
"type": "string",
"description": "Stamped gateway build that was serving when the change was marked live"
},
"built_at": {
"type": [
"string",
"null"
],
"description": "That build time"
},
"at": {
"type": "string",
"description": "When it was marked live"
},
"commit": {
"type": [
"string",
"null"
],
"description": "The change commit the writer attests the build contains"
},
"alters_existing_answers": {
"type": [
"boolean",
"null"
],
"description": "Whether it can alter answers a product already has"
}
},
"additionalProperties": true,
"description": "Set once the change is live"
},
"late": {
"type": [
"object",
"null"
],
"properties": {
"deploy_run_id": {
"type": "string",
"description": "The failed deploy workflow run id"
},
"reason": {
"type": "string",
"description": "Why the deploy failed"
},
"at": {
"type": "string",
"description": "When it was marked late"
},
"live_build_sha_instead": {
"type": [
"string",
"null"
],
"description": "The build live instead"
},
"fix_expected": {
"type": [
"string",
"null"
],
"description": "When the fix is expected"
}
},
"additionalProperties": true,
"description": "Set when a deploy failed; stays on the record after it goes live"
},
"notes": {
"type": [
"string",
"null"
],
"description": "Differences from the announcement and anything else a reader should know"
},
"updated_at": {
"type": "string",
"description": "When the record last changed"
}
},
"required": [
"task_id",
"status",
"kind",
"products",
"tools"
],
"additionalProperties": true
},
"error": {
"type": "string",
"description": "Why nothing was written: owner_only, not_announced, already_live, build_not_stamped, build_mismatch, state_changed"
},
"message": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"written"
],
"additionalProperties": true
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the product-change-log pack
{
"mcpServers": {
"product-change-log": {
"url": "https://gateway.pipeworx.io/product-change-log/mcp"
}
}
}
See Getting Started for client-specific install steps.