Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hubify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Search API

A single endpoint that fans out across nine entity types in a lab and returns case-insensitive substring hits, capped at five matches per category. Use it as the backing query for command palettes, MCP tool calls, and “what do we know about X?” workflows.

​
Search a Lab

​
labId
string
required
Convex ID of the lab to search.
​
q
string
required
Search query. Minimum 2 characters. Case-insensitive substring match.
curl "https://www.hubify.com/api/v1/search?labId=j57a8k9m2n3p4q5r&q=mcmc" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Response

Returns a single object with one array per entity type. Each array is capped at 5 hits. Empty arrays mean “no match in this category” (not “category disabled”).
​
experiments
object[]
required
Matches title, experimentId, or result.
​
papers
object[]
required
Matches title or target (target journal).
​
agents
object[]
required
Matches name, role, or model.
​
knowledge
object[]
required
Matches name, entityType, or description.
​
surveys
object[]
required
Matches name or description.
​
tasks
object[]
required
Matches title, description, or experimentId.
​
figures
object[]
required
Matches title or figureType.
​
datasets
object[]
required
Matches name, description, or datasetType.
​
contributions
object[]
required
Matches title, description, or type.

​
Behavior notes

  • Queries shorter than 2 characters return all empty arrays (not an error). Use this to short-circuit on the client.
  • Each entity object is the full Convex document, not a stripped projection. Render only the fields you need.
  • Search is read-only. Subject to the read rate limit.
  • Returns 400 if labId or q is missing.

​
Common Workflows

# Find every MCMC-related entity in the lab
curl "https://www.hubify.com/api/v1/search?labId=$LAB_ID&q=mcmc" \
  -H "Authorization: Bearer $HUBIFY_TOKEN" | jq '{
    experiments: .experiments | length,
    papers: .papers | length,
    knowledge: .knowledge | length
  }'

# Universal jump-to from a CLI palette
curl "https://www.hubify.com/api/v1/search?labId=$LAB_ID&q=$QUERY" \
  -H "Authorization: Bearer $HUBIFY_TOKEN" | jq '
    [.experiments[], .papers[], .agents[], .knowledge[]]
    | map({type: ._creationTime, title: .title // .name, id: ._id})
  '