---
# @generated by sylphx-gen 0.1.0 from contracts@fb95f0c42a0ec5d8e3cb694c0054b529c0b24b184112c65ef60c9044b4ce61f9. Do not edit.
title: "Spaces"
description: "The `spaces` collection of Sylphx Knowledge: A Space is the permission container of the graph: a workspace, a project, a team, one end user's private space, one agent's private space."
type: reference
product: knowledge
summary: "A Space is the permission container of the graph: a workspace, a project, a team, one end user's private space, one agent's private space."
updated: 2026-09-28
order: 900
---

A Space is the permission container of the graph: a workspace, a project, a team, one end user's private space, one agent's private space. Every Episode and Relation lives in exactly one space, and a principal sees a record only through a space it may read. Read and write are the share relations `reader`, `writer` and `owner` on the space, inherited through `parent`.

**Service** Sylphx Knowledge · **Resource type** `knowledge.sylphx.com/Space` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/spaces/{space}` · **Shape** `spec_status`

**Not available yet.** Sylphx Knowledge is declared in the registry but no backend serves it: every call answers `501` with the problem code `UNIMPLEMENTED`.

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/spaces/{space}`. |
| `uid` | `string` | `spc_<26 base32>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `SpaceSpec` | Desired state. Required. |
| `status` | `SpaceStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/spaces#get) | Gets a space. |
| `GET` | [`list`](/docs/api/spaces#list) | Lists spaces. |
| `POST` | [`create`](/docs/api/spaces#create) | Creates a space. |
| `PATCH` | [`update`](/docs/api/spaces#update) | Updates a space. |
| `DELETE` | [`delete`](/docs/api/spaces#delete) | Deletes a space. A space that still holds records is refused with `INVALID_STATE` unless `force` is set, which deletes its episodes and facts too. |

## get

Gets a space.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space` · scope `knowledge:read` · effect `read` · not available yet · [Request, response and examples](/docs/api/spaces/get)

## list

Lists spaces.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces` · scope `knowledge:read` · effect `read` · not available yet · paginated · [Request, response and examples](/docs/api/spaces/list)

## create

Creates a space.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces` · scope `knowledge:write` · effect `write` · not available yet · [Request, response and examples](/docs/api/spaces/create)

## update

Updates a space.

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space` · scope `knowledge:write` · effect `write` · not available yet · [Request, response and examples](/docs/api/spaces/update)

## delete

Deletes a space. A space that still holds records is refused with `INVALID_STATE` unless `force` is set, which deletes its episodes and facts too.

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/spaces/space` · scope `knowledge:write` · effect `destructive` · not available yet · [Request, response and examples](/docs/api/spaces/delete)