Skip to main content

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

FieldMeaning
idThe space's UUID (also the bytes16 hex on chain)
typePERSONAL (single-wallet owner) or DAO (community-governed)
pageThe 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 through personalSpace.publishEdit in the SDK. The wallet that owns the space submits directly.
  • DAO: edit goes through daoSpace.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 page entity 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.