GetProposal
Read one schema proposal by its ID: title, description, status, author, the source variant, and the proposal variant with the ID of its latest launch. Also returns the latest revision (its ID, summary, schema check, and launch), every review with its decision and comment, and whether the source variant changed since the proposal was created. hasUpstreamChanges does not say which subgraphs changed upstream. The proposal variant starts as a copy of every subgraph on the source variant and is not updated automatically; it picks up upstream changes only when the author pulls them in. So a diff of the two variants also shows changes published to the source since the proposal was created or last pulled upstream, reversed as if the proposal made them. hasUpstreamChanges is always false for proposals created before Nov 15, 2024. To see what the proposal itself changes, read its latest check with latestRevision.checkWorkflow.id and GetCheckResults: the check's changes cover every revision of the proposal and leave out upstream changes. If you diff the variants, compare each source subgraph's updatedAt with when the proposal was created or last pulled upstream, and do not treat a subgraph that is on only one side as added or removed by the proposal. GetVariantDetails lists the subgraph names on each variant. The write tools for a proposal take the graph ID and the proposal variant name from this response. ReviewProposal and AddProposalComment take latestRevision.id, and PublishProposalRevision takes backingVariant.latestLaunch.id as previousLaunchId. Provide the proposal ID, which GetProposals returns.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"proposalId": "<proposalId>"
},
"name": "GetProposal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| proposalId | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| errors | No | ||
| extensions | No |