Query a Space's Metadata
Before publishing to a space — or just to understand what kind of space you're looking at — query its metadata: governance type, page entity, members, editors.
Query
query SpaceMetadata($id: UUID!) {
space(id: $id) {
id
type
page {
id
name
}
}
}
{ "id": "41e851610e13a19441c4d980f2f2ce6b" }
Response
{
"data": {
"space": {
"id": "41e851610e13a19441c4d980f2f2ce6b",
"type": "DAO",
"page": {
"id": "8cb0a2b4adbf4627aa080cec5112099a",
"name": "AI"
}
}
}
}
Loading interactive query runner…
What the fields mean
| Field | Meaning |
|---|---|
id | The space's UUID (also the bytes16 hex on chain) |
type | PERSONAL (single-wallet owner) or DAO (community-governed) |
page | The space's "front door" entity — usually has the space's name, description, and any displayed blocks |
For full members/editors and governance details, see the Space reference page — it has fields like membersList, editorsList, and a few governance-specific connections.
Listing all spaces
query AllSpaces {
spaces(first: 100) {
id
type
page { name }
}
}
Use the spacesConnection variant if you need pagination on large counts.
Loading interactive query runner…
Why type matters
The publishing flow differs by space type:
PERSONAL: edit goes throughpersonalSpace.publishEditin the SDK. The wallet that owns the space submits directly.DAO: edit goes throughdaoSpace.proposeEdit— the proposal is created on chain, members vote, and (if approved) the edit is executed.
If you're writing a publishing tool, query space.type first and branch on it.
Notes
- Personal space ID = wallet's "personal" identity in the SDK. When publishing to your own personal space, the SDK expects
author: spaceId(yes, the spaceId itself — that's intentional for personal spaces). - The
pageentity is the canonical "this space" entity. Most metadata you'd associate with the space (its name, its description, its cover image) lives as values and relations on the page entity. - Spaces don't have rate limits announced. Be polite with bulk queries; throttle to ~10 req/s for safety.