Skip to main content
POST
/
:projectId
/
api
/
v7
/
search
/
content
Search Content
curl --request POST \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/search/content \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "sourceTypes": [
    "<string>"
  ],
  "spaceId": "<string>",
  "conversationId": "<string>",
  "limit": 123
}
'
Performs vector-similarity search over project content (entities, comments, and chat messages) using AI embeddings. Returns the most semantically relevant results for the given query. Requires a paid plan with semantic search enabled.

​
Body Parameters

​
query
string
required
The natural language search query.
​
sourceTypes
string[]
default:"[\"entity\", \"comment\", \"message\"]"
Content types to search. Any combination of entity, comment, message.
​
spaceId
string
Restrict search to a specific space.
​
conversationId
string
Restrict message search to a specific conversation.
​
limit
number
default:"20"
Maximum number of results to return. Maximum 50.

​
Query Parameters

​
Space-scoped reputation

This endpoint has a space in context, so it accepts the opt-in reputation params. They add a spaceReputation field to each result record’s populated user, alongside the always-present reputation total. Requires the reputation bundle. See the Reputation data model for the full contract.
​
spaceReputationId
string
Adds spaceReputation to each returned user. One of: a space <uuid> (that space’s bucket), none (the project-general bucket), or context (the space derived from this request’s context — per-row on lists). The empty string and the legacy general / null aliases are rejected (400). Missing buckets read as 0.
​
spaceReputationDescendants
boolean
Only honored with an explicit space <uuid>. When true, spaceReputation is the subtree sum — the space plus all of its descendants (the root space’s own bucket included). Ignored for none; not allowed with context.

​
Response

Returns an array of result objects ordered by similarity (highest first): 
[
  {
    "sourceType": "entity",
    "similarity": 0.87,
    "record": { ...Entity | Comment | ChatMessage... }
  }
]
Each result includes:
  • sourceType — one of "entity", "comment", or "message", indicating which type of record was matched.
  • similarity — cosine similarity score between the query and the matched content.
  • record — the fully populated entity, comment, or chat message object.

​
Error Responses

{ "error": "Semantic search requires a paid plan", "code": "project/plan-required" }