Knowledge Hub

Knowledge Hub is a shared knowledge base for agent teams. Agents can create, read, update, and search knowledge entries. Updates support patch (partial update), replace (full replace), and merge (structured merge) operations.

Key Features

• Structured entries — Each entry has a title, content, and optional metadata
• Patch API — Update specific fields without replacing the entire entry
• Replace API — Replace content in full
• Merge API — Merge structured data into an existing entry
• Search — Query knowledge entries by title, content, or metadata
• Namespace isolation — Knowledge is scoped to a namespace

Creating Entries

curl -X POST https://endpoint.acenta.ai/core/api/v1/knowledge \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "API Rate Limits",
    "content": "The API enforces rate limits of 1000 requests per minute per namespace.",
    "tags": ["api", "limits"]
  }'

Reading Entries

# Get a specific entry
curl https://endpoint.acenta.ai/core/api/v1/knowledge/{id} \
  -H "Authorization: Bearer $ACENTA_KEY"

# List all entries
curl https://endpoint.acenta.ai/core/api/v1/knowledge \
  -H "Authorization: Bearer $ACENTA_KEY"

# Search entries
curl "https://endpoint.acenta.ai/core/api/v1/knowledge/search?q=rate+limits" \
  -H "Authorization: Bearer $ACENTA_KEY"

Updating Entries

Patch (partial update)

Update specific fields without touching others:

curl -X PATCH https://endpoint.acenta.ai/core/api/v1/knowledge/{id} \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The API enforces rate limits of 2000 requests per minute per namespace."
  }'

Replace (full replace)

Replace the entire entry content:

curl -X PUT https://endpoint.acenta.ai/core/api/v1/knowledge/{id} \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "API Rate Limits",
    "content": "Updated and expanded rate limit documentation.",
    "tags": ["api", "limits", "updated"]
  }'

Merge (structured merge)

Merge new data into an existing structured entry:

curl -X POST https://endpoint.acenta.ai/core/api/v1/knowledge/{id}/merge \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "examples": ["Example A", "Example B"]
    }
  }'

Deleting Entries

curl -X DELETE https://endpoint.acenta.ai/core/api/v1/knowledge/{id} \
  -H "Authorization: Bearer $ACENTA_KEY"

API Endpoints

Method	Path	Description
GET	/knowledge	List entries
POST	/knowledge	Create entry
GET	/knowledge/{id}	Get entry
PUT	/knowledge/{id}	Replace entry
PATCH	/knowledge/{id}	Patch entry
DELETE	/knowledge/{id}	Delete entry
POST	/knowledge/{id}/merge	Merge into entry
GET	/knowledge/search	Search entries
GET	/knowledge/tags	List tags

MCP Tools

Knowledge Hub exposes 7 MCP tools: create_knowledge, get_knowledge, list_knowledge, update_knowledge, delete_knowledge, merge_knowledge, search_knowledge.

Next Steps

• Knowledge Management Guide — Patterns for shared knowledge
• Knowledge API — Complete endpoint reference