---
title: "space.build.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/space.build.read"
updated: null
---

# space.build.read · OpenVibe.Services

HTML: [space.build.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/space.build.read)

# `space.build.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Read a person's own spaces and their source files, as their agent (OpenVibe.Actor) works on them (plan 2026-10-22 §Z stage Z1: Space's builder becomes a task of the person's one agent). GET /api/v1/builder/spaces lists the person's spaces, GET /api/v1/builder/spaces/:id reads one, GET /api/v1/builder/spaces/:id/files reads its files, GET /api/v1/builder/spaces/:id/files/:path reads one of them, GET /api/v1/builder/spaces/:id/preview says where it can be seen. A first-party service names the person in X-OV-Subject; Space reads only that person's own spaces, and another person's space is the same 404 as one that does not exist.

- Owner: space (token audience `openvibe.space`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: standard
- Permissions: spaces:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: space.build-list@1
- Events: —
- Implemented by: - `GET /api/v1/builder/spaces`
- `GET /api/v1/builder/spaces/:id`
- `GET /api/v1/builder/spaces/:id/files`
- `GET /api/v1/builder/spaces/:id/files/:path`
- `GET /api/v1/builder/spaces/:id/preview`

[These routes in the API explorer](/docs/api/space#cap-space.build.read)