Hive Endpoints
Create and manage hives -- shared memory contexts where multiple agents and users can collaborate, share knowledge, and build collective intelligence.
Overview
Hives provide a shared memory space for groups of agents and users. Memories stored in a hive context are accessible to all members, enabling collaborative knowledge building. Each hive has its own memory pool separate from individual agent memories.
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/hives | Create a new hive |
GET | /v1/hives | List hives |
GET | /v1/hives/:id | Get a specific hive |
PUT | /v1/hives/:id | Update a hive |
DELETE | /v1/hives/:id | Delete a hive |
POST | /v1/hives/:id/members | Add a member to a hive |
DELETE | /v1/hives/:id/members/:userId | Remove a member from a hive |
Create Hive
List Hives
Get Hive
Update Hive
Delete Hive
Destructive action
Deleting a hive permanently removes all shared memories. Individual agent memories are not affected, but any memories stored in the hive context will be lost. This action cannot be undone.
Add Member
Remove Member
Hive Object
The following table describes all fields in a hive object.
| Field | Type | Description |
|---|---|---|
id | string | Unique hive identifier (prefixed with hive_) |
name | string | Human-readable hive name |
description | string | Description of the hive purpose |
config | object | Hive configuration (memory types, max members, visibility) |
member_count | integer | Total number of members in the hive |
memory_count | integer | Total number of shared memories |
members | array | List of member objects with id, role, and joined_at |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
