Skip to main content

Organization

The top-level account that owns all your infrastructure, projects, and team members.

An organization is the root of the Massdriver resource hierarchy. Everything you build and deploy lives under an organization: Projects contain your infrastructure designs, Environments (like staging and production) are where those designs come to life, and Instances are the actual running cloud resources.

Members access resources through group memberships with role-based permissions. Tag constraints defined at the organization level govern tagging across all child resources.

type Organization {
  id: ID!
  name: String!
  createdAt: DateTime!
  updatedAt: DateTime!
  logo: LogoOrganization
  tagConstraints(
    sort: OrganizationTagConstraintsSort
    cursor: Cursor
  ): OrganizationTagConstraintsPage
  tagSchema(
    scope: TagConstraintScope!
  ): Map!
}

Fields​

Organization.id ● ID! non-null scalar {#id}​

Organization.name ● String! non-null scalar {#name}​

Display name shown in the UI and CLI.

Organization.createdAt ● DateTime! non-null scalar {#created-at}​

When this organization was created (UTC).

Organization.updatedAt ● DateTime! non-null scalar {#updated-at}​

When this organization was last modified (UTC).

The organization's logo image, or null if no logo has been uploaded.

Organization.tagConstraints ● OrganizationTagConstraintsPage object {#tag-constraints}​

Paginated list of tag constraints that govern tagging rules across this organization.

Organization.tagConstraints.sort ● OrganizationTagConstraintsSort input {#organization-tag-constraints-sort}​

How to sort results. Defaults to alphabetical by key.

Organization.tagConstraints.cursor ● Cursor input {#organization-tag-constraints-cursor}​

Cursor from a previous page to fetch the next set of results.

Organization.tagSchema ● Map! non-null scalar {#tag-schema}​

Returns a JSON Schema document you can use to validate tags for a given resource scope.

The schema is derived from this organization's tag constraints. It includes properties for each allowed tag key and a required array for mandatory tags. If no constraints exist for the scope, returns {"type": "object"}.

Organization.tagSchema.scope ● TagConstraintScope! non-null enum {#organization-tag-schema-scope}​

The resource scope to generate the schema for (e.g., PROJECT, ENVIRONMENT).

Returned By​

organization query

Member Of​

OrganizationPayload object