Home / Directory / Apollo GraphOS / PublishProposalRevision
PublishProposalRevision
An MCP tool from the Apollo GraphOS server, run by Apollo.
Save a new revision of a schema proposal by publishing changed subgraph schemas to its proposal variant, the same action as Save revision in GraphOS Studio. GraphOS composes the proposal variant, records the diff against the source variant, and runs schema checks on it. The source variant does not change. Send only the subgraphs that change, each with its full SDL. previousLaunchId must be the proposal variant's latest launch ID from GetProposal. If someone saved a revision since, the call fails, so read the proposal again before you retry. GraphOS saves the revision even when the schema does not compose, so this call succeeding does not mean the change is valid. Call GetProposal after the check finishes: latestRevision.checkWorkflow.status and latestRevision.launch.status show the result, and GetCheckResults takes the check ID for the details. Returns the proposal's new latest revision, or an error with a message. Provide the graph ID, the proposal variant name, previousLaunchId, a unique revision label, a s
Name on the gateway: apollo_graphos__PublishProposalRevision.
Parameters
| Name | Type | Description |
|---|---|---|
graphId required | string | |
proposalVariant required | string | |
previousLaunchId required | string | |
revision required | string | |
summary required | string | |
subgraphs required | array | |
gitContext | mixed |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "apollo_graphos__PublishProposalRevision",
"arguments": {
"graphId": "…",
"proposalVariant": "…",
"previousLaunchId": "…",
"revision": "…",
"summary": "…",
"subgraphs": []
}
}The first call connects Apollo GraphOS to your account automatically; nothing to set up. About this server.
Try asking
Use the publishproposalrevision tool with graphId set to ….