Space

Last updated: June 22, 2026

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" } },
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } },
    "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.
  • plan: A Refer<Plan> that points to this Space's subscription plan (e.g. free).

System properties (sys) and body

Every Space carries common system properties in the sys object. organization is a Refer<Organization>, plan is a Refer<Plan>, 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.
planRefer<Plan>The subscription plan. Example: free.
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.

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.