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.

​
Knowledge Base API

Today only GET /v1/knowledge (list) and POST /v1/knowledge (create) are shipped. The single-entry routes (GET /v1/knowledge/{id}, /related, /search) are planned, not yet live. Read individual entries via the lab’s Convex knowledge query for now; this page documents the target REST shape.
The Knowledge Base is a structured wiki that grows as your agents work. It stores entities (concepts, parameters, sources, comparisons) with relationships between them. Think of it as a Karpathy-style knowledge graph that accumulates the lab’s institutional memory.

​
Entity Types

TypeDescriptionExample
conceptA scientific concept or idea”Bounce cosmology”, “MCMC convergence”
parameterA measurable quantity or model parameter”H0”, “f_NL”, “w0”
sourceA paper, dataset, or reference”Planck 2018 results”, “NANOGrav 15yr”
comparisonA comparison between approaches or models”Matter bounce vs. ekpyrotic”

​
Create an Entry

​
labId
string
required
Lab this entry belongs to.
​
entityType
string
required
Entity type: concept, parameter, source, or comparison.
​
name
string
required
Display name of the entity.
​
slug
string
URL-safe identifier. Auto-generated from name if omitted.
​
description
string
Detailed description. Supports markdown.
​
relatedEntities
string[]
Slugs of related knowledge entries.
curl -X POST https://www.hubify.com/api/v1/knowledge \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "j57a8k9m2n3p4q5r",
    "entityType": "parameter",
    "name": "Local Non-Gaussianity (f_NL)",
    "slug": "f-nl",
    "description": "The amplitude of local-type primordial non-Gaussianity. The matter bounce prediction is f_NL = -35/8 = -4.375, parameter-free and testable by SPHEREx.",
    "relatedEntities": ["matter-bounce", "spherex", "galaxy-bispectrum"]
  }'
​
data
object

​
List Entries

​
labId
string
required
Lab ID.
​
entityType
string
Filter by type: concept, parameter, source, comparison.
​
limit
number
default:"50"
Results per page.
​
cursor
string
Pagination cursor.
curl "https://www.hubify.com/api/v1/knowledge?labId=j57a8k9m2n3p4q5r&entityType=parameter" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Get an Entry

Retrieve a single entry by slug or ID. 
curl https://www.hubify.com/api/v1/knowledge/f-nl \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Update an Entry

​
name
string
Updated display name.
​
description
string
Updated description.
​
relatedEntities
string[]
Updated list of related entity slugs.
curl -X PATCH https://www.hubify.com/api/v1/knowledge/f-nl \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated with SPHEREx forecast: sigma=0.93 conservative, 4.7 sigma detection expected by 2027.",
    "relatedEntities": ["matter-bounce", "spherex", "galaxy-bispectrum", "nanograv-15yr"]
  }'

​
Delete an Entry

curl -X DELETE https://www.hubify.com/api/v1/knowledge/f-nl \
  -H "Authorization: Bearer $HUBIFY_TOKEN"
Full-text search across all knowledge entries in a lab.
​
labId
string
required
Lab ID to search within.
​
query
string
required
Search query. Matches against name and description.
​
entityType
string
Restrict search to a specific entity type.
​
limit
number
default:"20"
Maximum results.
curl "https://www.hubify.com/api/v1/knowledge/search?labId=j57a8k9m2n3p4q5r&query=non-gaussianity" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Relationships

Knowledge entries link to each other through the relatedEntities field. This creates a navigable knowledge graph. Retrieve all entries related to a given entry (one hop in the graph). 
curl https://www.hubify.com/api/v1/knowledge/f-nl/related \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Add a Relationship

curl -X POST https://www.hubify.com/api/v1/knowledge/f-nl/related \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"relatedSlug": "pbh-abundance"}'

​
Remove a Relationship

curl -X DELETE https://www.hubify.com/api/v1/knowledge/f-nl/related/pbh-abundance \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

​
Auto-Population

Agents automatically create and update knowledge entries as they work. When an experiment completes, the research lead agent:
  1. Extracts new concepts and parameters from the results
  2. Creates or updates knowledge entries
  3. Links them to related entities
  4. Logs the update in the Activity Feed
You can disable auto-population per lab in the lab settings.