Organization

Last updated: June 22, 2026

An Organization is the top-level container that holds Spaces. A company or a team corresponds to one Organization, and several Spaces live under it. The subscription plan (plan) and membership are managed at the Organization level, so billing and member permissions apply based on this Organization rather than the Space.

You read the list of Organizations you belong to with GET /me/organization-memberships. This resource has no endpoint that returns the full list.

Resource structure

The following is the single-read response for the Organization "DailyWear Company". It has sys (system properties) and the body properties name and description.

{
  "sys": {
    "id": "ilLRJxDp",
    "type": "Organization",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.832Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.832Z",
    "version": 1,
    "isOfficial": false,
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } }
  },
  "name": "DailyWear Company",
  "description": "Company running an online clothing and accessories store"
}

Key properties:

  • name: The name of the Organization (1-64 characters). It is the display name of the company or team.
  • description: A description of the Organization (1-128 characters, optional).
  • plan: A Refer<Plan> that points to this Organization's subscription plan (e.g. free). The billing plan is tied here.
  • isOfficial: Whether this is an official Organization (boolean).

System properties (sys) and body

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

PropertyTypeDescription
idstringUnique resource identifier.
typestringResource kind. For an Organization this is always "Organization".
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.
isOfficialbooleanWhether this is an official Organization.
planRefer<Plan>The subscription plan. Example: free.

Body properties:

PropertyTypeDescription
namestring (1-64)The Organization name. Specified on create and update.
descriptionstring (1-128)The Organization description. Optional.
iconstring (read) / object (write)The Organization 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).

An Organization 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 Organization.

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.