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

Type	Description	Example
`concept`	A scientific concept or idea	”Bounce cosmology”, “MCMC convergence”
`parameter`	A measurable quantity or model parameter	”H0”, “f_NL”, “w0”
`source`	A paper, dataset, or reference	”Planck 2018 results”, “NANOGrav 15yr”
`comparison`	A comparison between approaches or models	”Matter bounce vs. ekpyrotic”

Create an Entry

string

required

Lab this entry belongs to.

string

required

Entity type: concept, parameter, source, or comparison.

string

required

Display name of the entity.

string

URL-safe identifier. Auto-generated from name if omitted.

string

Detailed description. Supports markdown.

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"]
  }'

const entry = await hubify.knowledge.create({
  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"],
});

object

Show Knowledge entry object

string

required

Convex document ID.

string

required

Parent lab ID.

string

required

Entity type.

string

required

Display name.

string

required

URL-safe identifier.

string

Markdown description.

Related entity slugs.

number

required

Creation timestamp (ms).

number

required

Last update timestamp (ms).

List Entries

string

required

Lab ID.

string

Filter by type: concept, parameter, source, comparison.

number

default:"50"

Results per page.

string

Pagination cursor.

curl "https://www.hubify.com/api/v1/knowledge?labId=j57a8k9m2n3p4q5r&entityType=parameter" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const entries = await hubify.knowledge.list({
  labId: "j57a8k9m2n3p4q5r",
  entityType: "parameter",
});

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"

const entry = await hubify.knowledge.get({ slug: "f-nl" });

Update an Entry

string

Updated display name.

string

Updated description.

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"]
  }'

await hubify.knowledge.update({
  slug: "f-nl",
  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"

await hubify.knowledge.delete({ slug: "f-nl" });

Search

Full-text search across all knowledge entries in a lab.

string

required

Lab ID to search within.

string

required

Search query. Matches against name and description.

string

Restrict search to a specific entity type.

number

default:"20"

Maximum results.

curl "https://www.hubify.com/api/v1/knowledge/search?labId=j57a8k9m2n3p4q5r&query=non-gaussianity" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const results = await hubify.knowledge.search({
  labId: "j57a8k9m2n3p4q5r",
  query: "non-gaussianity",
});

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"

const related = await hubify.knowledge.getRelated({ slug: "f-nl" });
// Returns: [{ slug: "matter-bounce", ... }, { slug: "spherex", ... }, ...]

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"}'

await hubify.knowledge.addRelation({
  slug: "f-nl",
  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"

await hubify.knowledge.removeRelation({
  slug: "f-nl",
  relatedSlug: "pbh-abundance",
});

Auto-Population

Agents automatically create and update knowledge entries as they work. When an experiment completes, the research lead agent:

Extracts new concepts and parameters from the results
Creates or updates knowledge entries
Links them to related entities
Logs the update in the Activity Feed

You can disable auto-population per lab in the lab settings.

Overview

Labs

Data

Compute

Lab Ops

Knowledge Base

Knowledge Base API

Entity Types

Create an Entry

List Entries

Get an Entry

Update an Entry

Delete an Entry

Search

Relationships

Add a Relationship

Remove a Relationship

Auto-Population

​Knowledge Base API

​Entity Types

​Create an Entry

​List Entries

​Get an Entry

​Update an Entry

​Delete an Entry

​Search

​Relationships

​Get Related Entries

​Add a Relationship

​Remove a Relationship

​Auto-Population

Knowledge Base API

Entity Types

Create an Entry

List Entries

Get an Entry

Update an Entry

Delete an Entry

Search

Relationships

Get Related Entries

Add a Relationship

Remove a Relationship

Auto-Population