Space

A Space is the workspace that holds all the content of a single project. The Content Type that defines content structure, the actual data as Content, Media such as images and files, and the language settings as Locale all live inside one Space. A Space belongs under its parent container, an Organization, and you usually keep one Space per service.

You read the list of Spaces you belong to with GET /me/space-memberships.

Resource structure

The following is the single-read response for the Space "DailyWear Store". It has sys (system properties) and the body property name.

{
  "sys": {
    "id": "tcq4V2Xb",
    "type": "Space",
    "organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T14:56:04.737Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-14T14:56:58.670Z",
    "version": 2
  },
  "name": "DailyWear Store"
}

Key properties:

  • name: The name of the Space (1-64 characters). It is the display name of the project or service.
  • organization: A Refer<Organization> that points to the parent Organization this Space belongs to.

The subscription plan is tied to the parent Organization, not to the Space. To check or change the plan, see Organization.

System properties (sys) and body

Every Space carries common system properties in the sys object. organization is a Refer<Organization>, and createdBy and updatedBy are in the Refer shape ({ "sys": { "id", "type": "Refer", "targetType" } }).

PropertyTypeDescription
idstringUnique resource identifier.
typestringResource kind. For a Space this is always "Space".
organizationRefer<Organization>The parent Organization this Space belongs to.
createdByRefer<User>The user who created it.
createdAtstring (date-time)Creation time.
updatedByRefer<User>The user who last updated it.
updatedAtstring (date-time)Last update time.
versioninteger (≥1)Resource version. It increases by 1 with every change.

Body properties:

PropertyTypeDescription
namestring (1-64)The Space name. Specified on create and update.
descriptionstring (1-128)The Space description. Optional.
iconstring (read) / object (write)The Space icon. In responses it is an image URL string. In update requests you send it as an object that points to an uploaded file: { "upload": { "sys": { ..., "targetType": "Upload" } } } (a reference to an Upload obtained from the Upload API).

A Space is a settings resource with no publishing concept. So unlike Content and Media, its sys has no publish, archive, or status, only version. The version increases each time you update the Space.

The setting that replaces a Space's home screen with another page does not live on this resource. It lives on the parent Organization: set Organization's consoleHomeUrl, and the home screen of every Space under it shows that page instead.

Errors

These are the codes you meet when working with a Space. For codes that are common to every resource, see common errors.

CodeCondition
WGL422024The caller tried to delete a Space that still had at least one Content Type, Content, Media, or Web Hosting inside it. That Space can be deleted only after everything left in it has been deleted.
WGL422046The file uploaded as the icon exceeds the allowed size.
WGL422047The file uploaded as the icon is not a PNG, JPG, or WebP.

API

The base URL for all endpoints below is https://cma.weegloo.com/v1, and a Bearer token that authenticates against CMA is required in the Authorization header. Update and partial update must also send the X-Weegloo-Version header (the current resource's sys.version) for optimistic concurrency control. Create and delete do not have this header. List, create, update, partial update, and delete live under the parent Organization path (/organizations/{organizationId}/spaces). The single read can use the direct /spaces/{spaceId} path as shown below (the single read is also available on the parent Organization path /organizations/{organizationId}/spaces/{spaceId}).

  • Organization: The parent Organization this Space belongs to.
  • Space Membership: Space members and reading the Spaces you belong to.
  • Locale: The language settings of a Space.