UpdateProposalReviewers
Add or remove requested reviewers on a schema proposal, the same action as the Reviewers menu in GraphOS Studio. While the proposal is open, GraphOS emails each reviewer you add, every time, including someone already requested. Adding to a DRAFT proposal and removing a reviewer send no email. Only a requested reviewer can call ReviewProposal. Both lists take GraphOS user IDs, which GetOrganizationMembers returns. Pass either list or both. Only organization members can be reviewers, and GraphOS returns a ValidationError that names any other ID. The proposal's author cannot be a reviewer. This tool needs the GraphOS sign-in (OAuth) or a personal API key in the x-api-key header. GraphOS checks reviewers against the organization's members, which a graph key cannot read, so the call fails with NOT_ALLOWED_BY_USER_ROLE. The Platform API does not return the list of requested reviewers, so this tool cannot read it back. Check the proposal in GraphOS Studio to see it. Adding a reviewer who is already requested, removing one who is not, or passing neither list still returns the proposal, so a success does not mean anything changed. Remove only the people the user named. Returns the proposal's ID, or an error with a message. Provide the graph ID, the proposal variant name from GetProposal, and the user IDs to add, to remove, or both.
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": {
"graphId": "<graphId>",
"proposalVariant": "<proposalVariant>"
},
"name": "UpdateProposalReviewers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| graphId | Yes | ||
| proposalVariant | Yes | ||
| reviewerUserIdsToAdd | No | ||
| reviewerUserIdsToRemove | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| errors | No | ||
| extensions | No |