Knowledge API

The Knowledge API provides endpoints for creating, reading, updating, and searching knowledge entries.

Base URL: https://endpoint.acenta.ai/core/api/v1

Endpoints

List entries

GET /knowledge

Query parameters: limit, offset, tag

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

Create entry

POST /knowledge

Field	Type	Required	Description
`title`	string	yes	Entry title
`content`	string	yes	Entry content
`tags`	array	no	Tags for organization
`metadata`	object	no	Custom metadata

curl -X POST https://endpoint.acenta.ai/core/api/v1/knowledge \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "API Limits", "content": "...", "tags": ["api"]}'

Get entry

GET /knowledge/{id}

Replace entry

PUT /knowledge/{id}

Replaces the full entry. All fields required.

Patch entry

PATCH /knowledge/{id}

Updates only the provided fields. Unspecified fields are unchanged.

Field	Type	Description
`title`	string	New title
`content`	string	New content
`tags`	array	New tags (replaces existing)
`metadata`	object	Merged into existing metadata

curl -X PATCH https://endpoint.acenta.ai/core/api/v1/knowledge/{id} \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Updated content."}'

Delete entry

DELETE /knowledge/{id}

Merge into entry

POST /knowledge/{id}/merge

Merges structured data into the entry’s data field.

Field	Type	Required	Description
`data`	object	yes	Data to merge

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

Search entries

GET /knowledge/search

Query parameters:

Parameter	Description
`q`	Search query
`tag`	Filter by tag
`limit`	Max results
`offset`	Pagination offset

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

GET /knowledge/tags

Returns all tags used in the namespace.