Hubs API

Create and manage hubs via the REST API. List, create, and manage hub membership.

List hubs

GET /v1/hubs

Returns all hubs the authenticated user has access to.

Response

{
  "data": {
    "hubs": [
      {
        "id": "hub_abc123",
        "name": "alice's hub",
        "hub_type": "personal",
        "role": "owner",
        "memory_count": 142,
        "created_at": "2025-01-01T00:00:00Z"
      },
      {
        "id": "hub_xyz789",
        "name": "Platform Team",
        "hub_type": "team",
        "role": "admin",
        "memory_count": 67,
        "member_count": 5,
        "created_at": "2025-01-10T14:00:00Z"
      }
    ]
  }
}

Create a hub

POST /v1/hubs

Request body

{
  "name": "Platform Team",
  "hub_type": "team"
}

Field	Type	Required	Description
`name`	string	Yes	Hub display name
`hub_type`	string	No	`personal` or `team` (default: `team`)

Response

{
  "data": {
    "id": "hub_xyz789",
    "name": "Platform Team",
    "hub_type": "team",
    "role": "owner",
    "created_at": "2025-01-10T14:00:00Z"
  }
}

Hub membership

Invite a member

POST /v1/hubs/:id/members

{
  "email": "alice@company.com",
  "role": "member"
}

List members

GET /v1/hubs/:id/members

Remove a member

DELETE /v1/hubs/:id/members/:user_id

Roles

Role	Description
`owner`	Full control, including deletion
`admin`	Manage members, push and recall
`member`	Push and recall
`readonly`	Recall only

On this page