GraphQL — cloud

Source graphql/cloud.graphql + graphql/common.graphql. Endpoint /api/v1/graphql, subscriptions over graphql-ws.

Query

Field	Type	@auth scope
`info`	`CloudInfo!`	anon
`account`	`Account`	any
`orgs(first: Int, after: String)`	`OrgConnection!`	any
`org(orgId: UUID!)`	`Org`	org:read
`orgMembers(orgId: UUID!, first: Int, after: String)`	`MemberConnection!`	org:read
`orgInstallations(orgId: UUID!, first: Int, after: String)`	`InstallationConnection!`	registry:read
`ownInstallation`	`Installation`	registry:self
`enrollmentRequest(userCode: String!)`	`EnrollmentState`	any

Mutation

Field	Type	@auth scope
`signIn(input: SignInInput!)`	`CloudSession!`	anon
`refreshSession(refreshToken: String!)`	`CloudSession!`	anon
`signOut`	`Boolean!`	any
`patchAccount(patch: AccountPatch!)`	`Account!`	any
`createOrg(input: OrgInput!)`	`Org!`	any
`patchOrg(orgId: UUID!, patch: OrgPatch!)`	`Org!`	org:write
`createOrgInvitation(orgId: UUID!, input: InvitationInput!)`	`Invitation!`	members:write
`acceptInvitation(token: String!)`	`Org!`	any
`approveEnrollmentRequest(userCode: String!, input: EnrollmentApprovalInput!)`	`EnrollmentState!`	registry:write
`denyEnrollmentRequest(userCode: String!)`	`EnrollmentState!`	registry:write

Subscription

Field	Type	@auth scope	Description
`events(topics: [String!]!, sinceSeq: Int)`	`Event!`	any	cloud topics: cloud/{orgId}/installations/{id}, cloud/{orgId}/catalogue/…, user/{userId}/notifications
`installationStatus(orgId: UUID!)`	`Installation!`	registry:read

type Account

Field	Type	@auth	Description
`id`	`UUID!`
`email`	`String!`
`emailVerified`	`Boolean!`
`displayName`	`String`
`locale`	`String`
`platformRole`	`String!`
`status`	`String!`
`hardDeleteAfter`	`DateTime`
`memberships`	`[Membership!]`
`createdAt`	`DateTime!`

input AccountPatch

Field	Type	@auth	Description
`displayName`	`String`
`locale`	`String`

scalar Boolean

The `Boolean` scalar type represents `true` or `false`.

type CloudInfo

Field	Type	@auth	Description
`product`	`String!`
`serverVersion`	`String!`
`contractVersion`	`String`
`instanceId`	`UUID!`
`apiVersions`	`[String!]!`
`transports`	`JSON`
`auth`	`JSON`
`links`	`JSON`

type CloudSession

Field	Type	@auth	Description
`accessToken`	`String!`
`tokenType`	`String!`
`expiresIn`	`Int!`
`refreshToken`	`String`

scalar DateTime

RFC 3339 UTC timestamp with milliseconds, e.g. 2026-10-19T12:00:00.000Z.

scalar DocId

Document-scoped id ^[A-Za-z0-9._-]{1,64}$ (.dome ids, aliases default / main).

input EnrollmentApprovalInput

Field	Type	@auth	Description
`orgId`	`UUID!`
`domeId`	`UUID`
`name`	`String`

type EnrollmentState

Field	Type	@auth	Description
`userCode`	`String!`
`status`	`String!`
`name`	`String`
`expiresAt`	`DateTime`

type Event

Event envelope (02e §7.1): `data` is the event-kinds payload (resource / patch / revision).

Field	Type	@auth	Description
`id`	`UUID!`
`seq`	`Int!`
`topic`	`String!`
`kind`	`String!`
`ts`	`DateTime!`
`data`	`JSON!`

type EventConnection

Field	Type	Description
`nodes`	`[Event!]!`
`pageInfo`	`PageInfo!`
`lastSeq`	`Int`	Highest seq delivered in this page.
`resync`	`Boolean!`	True when the requested sinceSeq is older than the ring buffer: re-read state.

type Installation

Field	Type	@auth	Description
`id`	`UUID!`
`orgId`	`UUID!`
`domeId`	`UUID`
`name`	`String!`
`platform`	`String`
`os`	`String`
`arch`	`String`
`mediaserverVersion`	`String`
`status`	`String!`
`telemetryLevel`	`String`
`enrolledAt`	`DateTime`
`lastSeenAt`	`DateTime`

type InstallationConnection

Field	Type	@auth	Description
`nodes`	`[Installation!]!`
`pageInfo`	`PageInfo!`

scalar Int

The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

type Invitation

Field	Type	Description
`id`	`UUID!`
`email`	`String!`
`role`	`OrgRole!`
`expiresAt`	`DateTime!`
`token`	`String`	returned once, by createOrgInvitation

input InvitationInput

Field	Type	@auth	Description
`email`	`String!`
`role`	`OrgRole!`

scalar JSON

Any JSON value; the field description names the JSON Schema it is validated against.

type Member

Field	Type	@auth	Description
`userId`	`UUID!`
`email`	`String`
`displayName`	`String`
`role`	`OrgRole!`
`joinedAt`	`DateTime!`

type MemberConnection

Field	Type	@auth	Description
`nodes`	`[Member!]!`
`pageInfo`	`PageInfo!`

type Membership

Field	Type	@auth	Description
`orgId`	`UUID!`
`orgName`	`String`
`role`	`OrgRole!`

type Org

Field	Type	@auth	Description
`id`	`UUID!`
`name`	`String!`
`kind`	`String!`
`country`	`String`
`contactEmail`	`String`
`myRole`	`OrgRole`
`createdAt`	`DateTime!`

type OrgConnection

Field	Type	@auth	Description
`nodes`	`[Org!]!`
`pageInfo`	`PageInfo!`

input OrgInput

Field	Type	@auth	Description
`name`	`String!`
`kind`	`String!`
`country`	`String`
`contactEmail`	`String`

input OrgPatch

Field	Type	@auth	Description
`name`	`String`
`country`	`String`
`contactEmail`	`String`

enum OrgRole

OWNER ADMIN OPERATOR AUTHOR VIEWER UNKNOWN

type PageInfo

Relay page info.

Field	Type	@auth	Description
`hasNextPage`	`Boolean!`
`endCursor`	`String`

type Problem

RFC 9457 problem (also in errors[].extensions.problem).

Field	Type	@auth	Description
`type`	`String!`
`title`	`String!`
`status`	`Int!`
`code`	`String!`
`detail`	`String`
`instance`	`String`
`traceId`	`String`
`errors`	`[ProblemError!]`

type ProblemError

Field	Type	@auth	Description
`pointer`	`String!`
`detail`	`String!`

input SignInInput

Field	Type	@auth	Description
`email`	`String!`
`password`	`String!`
`client`	`String`

scalar String

The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

scalar UUID

Lowercase RFC 9562 UUID (server resources: UUIDv7).

NativeMindNONC · commercial use → NativeMind sales · [email protected]