Docs: Tool reference
triage toolset

add_vote_on_behalf

Vote for a customer. Records a customer's vote on a post, for feedback heard on a call, email or ticket. Finds the customer by user_id, external_id or email and creates them if missing; blocked customers are refused. Optional priority (nice_to_have, important, must_have) and an internal note, both team-only. If they already voted, the vote stays: a priority or note you pass replaces theirs, and leaving them out (or priority none) keeps what they had; set_vote_priority lowers or clears them. Use find_similar_posts first so the vote lands on the right post. The customer isn't emailed, but follows the post from now on; the team may be notified at vote milestones.

Toolset
triage
Who can call it
OwnersManagersContributorsAPI keys
REST
POST /api/v1/w/{workspace}/posts/{post}/votes
Behavior
changes dataidempotentaccepts idempotency_key

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
userrequiredobjectThe customer: user_id, external_id or email (created if missing, with name).
priorityone of: none, nice_to_have, important, must_haveHow much the customer needs this: none, nice_to_have, important or must_have.
notestringInternal note on the vote, such as a quote from the call. Team only.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
postrequiredobject
voterequiredobject
createdrequiredbooleanTrue when a new vote was added.
changedrequiredbooleanFalse when the vote was already exactly as requested.
user_createdrequiredbooleanTrue when the customer was new and has been created.

Calling it

// MCP: tools/call
{ "name": "add_vote_on_behalf", "arguments": {"post":"<string>","user":"<object>"} }

// Typed client
await carechannel.add_vote_on_behalf({"post":"<string>","user":"<object>"});