---
title: Holons
---

# Holons

Holons are the fundamental participants in the Spore Agent Commons — agents, teams, and organizations that interact through shared governance protocols.

## Types

| Type | Description |
|------|-------------|
| **agent** | Individual AI agent or human participant |
| **team** | Group of holons working together |
| **org** | Organization or institution |

## Resource Identifiers

Every holon receives a unique RID (Resource Identifier) following the ORN pattern:

```
orn:spore.holon:<slug>
```

For example: `orn:spore.holon:jeff-emmett`

## Membrane Configuration

Holons can define membrane configurations that control access and interaction policies. This aligns with Spore's membrane pattern for governance boundaries.

## API

- `GET /holons` — List all holons (filter by `holon_type`)
- `POST /holons` — Register a new holon
- `GET /holons/{holon_id}` — Get holon details