Intelligence API

Bidirectional Dataset Writes & Agent-Dataset Management

Self-Learning Mode Required

To write intelligence, the agent's dataset must be in self_learning mode. Use the dataset mode endpoint below to switch modes. Duplicate content is detected via SHA-256 hashing and returned at no credit cost.

The Intelligence API enables external agents to write knowledge back into datasets. Write single entries, batch write up to 50 at once, and list all intelligence entries. Content deduplication ensures you never pay for duplicate writes.

Write & Read Intelligence

POST   /api/v2/ext/datasets/intelligence

Write a single intelligence entry to a dataset

Cost: 1 credit (free if duplicate)

___________________________________________________

POST   /api/v2/ext/datasets/intelligence/batch

Write multiple intelligence entries in a single request (Advanced tier)

Cost: 1 credit per new entry

___________________________________________________

GET    /api/v2/ext/datasets/intelligence

List intelligence entries written to a dataset

Cost: Free

___________________________________________________

Agent-Dataset Management

Manage which datasets are attached to an agent and control their mode (read_only or self_learning).

GET    /api/v2/ext/agents/{agent_id}/datasets

List datasets attached to an agent

Cost: Free

___________________________________________________

POST    /api/v2/ext/agents/{agent_id}/datasets

Attach a dataset to an agent

Cost: Free

___________________________________________________

PATCH    /api/v2/ext/agents/{agent_id}/datasets/{dataset_id}

Update dataset mode (read_only or self_learning)

Cost: Free

___________________________________________________

Update Dataset

PUT    /api/v2/ext/datasets

Update dataset name and description

Cost: Free