Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getGet FeedbackputUpdate FeedbackgetList PostspostCreate PostgetGet PostputUpdate PostdelDelete PostputUpdate Post StatusputUpdate Post TopicspostSet Post Pending ApprovalpostUnmerge PostgetList StatusespostCreate StatusputUpdate StatusdelDelete StatusgetList TopicspostCreate TopicputUpdate TopicdelDelete TopicgetList CommentsputUpdate CommentpostArchive CommentgetGet Public FeedbackgetList Public PostspostCreate Public PostgetGet Public PostgetList Public StatusesgetList Public TopicsgetList Public CommentspostCreate Public CommentputUpdate Public CommentpostArchive Public CommentpostSet Public VotepostSet Public FollowgetList Public Engagements
Feedback

Set Public Vote

Sets a visitor's vote on a public post. Voting also follows the post. Removing the vote keeps the follow. Public and unauthenticated.

POST
/feedback/{projectId}/posts/{postId}/vote

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

postIdrequiredstring

ID of the post.

projectIdrequiredstring

ID of the project that publishes the post.

Request Body

application/json

emailstring | string

Email address so a follow can receive status-change mail. An empty string clears it.

surfacerequiredstring

Which public portal the visitor is on. Votes and comments are tracked separately on each.

Value in: "feedback" | "roadmap"
visitorIdrequiredstring

Random per-project id the portal stores in the visitor's browser.

Format: uuid
votedrequiredboolean

Desired vote. true adds a vote and a follow. false removes the vote and keeps the follow.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.saasco.com/api/v2/feedback/string/posts/string/vote" \  -H "Content-Type: application/json" \  -d '{    "surface": "feedback",    "visitorId": "e45934e1-5fd4-4651-b7bc-50c977a3b8c5",    "voted": true  }'
{
  "following": true,
  "voteCount": 9007199254740991,
  "voted": true
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Archive Public Comment

Lets a visitor archive their own comment within the edit window. Public and unauthenticated. The visitorId has to match the comment.

Set Public Follow

Sets whether a visitor follows a post, so they can be emailed when its status changes. Public and unauthenticated. Send the desired state, not a toggle.