Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
Set up SupportWrite the widget copy
getList Conversation MessagesgetSearch Conversation MessagespostMark Messages SeenpostGet Inbound Email Attachment
Set up ShortlinksCreate short linksSet up Social ProofSocial Proof templatesSet up FeedbackDraft feedback postsSet up ChangelogDraft changelog entriesSet up DisputesSet up Benchmarks
SupportMessages

Search Conversation Messages

Returns conversation ids whose message bodies match every search term. Caps at 200 matches. Does not search contact names, emails, or subjects — those live on the listing and are matched there. Omitted state searches open conversations. all includes spam unless includeSpam is false.

GET
/projects/{projectId}/support/conversations/search

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project whose conversations to search.

Query Parameters

includeSpamboolean
searchrequiredstring

Space-separated terms. Every term must appear somewhere in the thread, though not in one message.

statestring
Value in: "all" | "open" | "closed" | "spam"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/support/conversations/search?search=string"
[
  "string"
]
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

List Conversation Messages

Returns the transcript of one conversation. Conversation metadata (contact, assignee, state) is on the listing endpoints, not here. Returns 404 if the conversation does not belong to the project.

Mark Messages Seen

Marks customer comments on a conversation as seen by the team. Stamps `seenByTeamAt` on the given message ids that are still unseen. Project-wide, not per member: the first teammate (or API key) to open the thread clears the unread count for everyone.