API Reference
Briefs API
API endpoints for knowledge briefs, versions, and diffs.
Get Knowledge Brief
GET /agents/{agent_id}/briefQuery Parameters:
| Param | Type | Default | Description |
|---|---|---|---|
version | string | latest | Specific version to retrieve |
Response: 200
{
"agent_id": "550e8400-...",
"version": "3",
"previous_version": "2",
"compiled_at": "2026-03-30T10:00:00Z",
"brief": "The agent demonstrates strong capabilities in...",
"gap_summary": [
"Lacks SEO keyword research frameworks",
"No jurisdiction-specific tax guidance"
]
}Get Brief Version Info
GET /agents/{agent_id}/brief/versionCheck if a newer brief version is available.
Response: 200
{
"current_version": "3",
"latest_version": "5",
"pinned_version": null,
"has_update": true,
"latest_compiled_at": "2026-03-31T08:00:00Z"
}Get Brief Diff
GET /agents/{agent_id}/brief/diffCompare two brief versions.
Query Parameters:
| Param | Type | Required | Description |
|---|---|---|---|
from_version | string | Yes | Starting version |
to_version | string | Yes | Ending version |
Response: 200
{
"from_version": "1",
"to_version": "3",
"summary": "Two new knowledge gaps identified...",
"additions": [...],
"deletions": [...],
"modifications": [...]
}Compile Brief
POST /agents/{agent_id}/brief/compileTrigger manual brief recompilation.
Response: 202
{
"status": "accepted",
"message": "Brief generation started"
}SDK Equivalent
brief = await client.briefs.get(agent_id="...")
version = await client.briefs.version(agent_id="...")
diff = await client.briefs.diff(agent_id="...", from_version="1", to_version="3")
await client.briefs.compile(agent_id="...")