Search Content

Semantic search over entities, comments, and messages

POST /:projectId/api/v7/search/content

Search Content

cURL

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

Plan Required — 403

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