Grafbase API

The Grafbase Platform GraphQL API.

API Endpoints
https://api.grafbase.com/graphql

Queries

accessTokens

Description

Returns user access tokens for the user issuing the request.

Response

Returns an AccessTokenConnection!

Arguments
Name Description
after - String
before - String
first - Int
last - Int

Example

Query
query accessTokens(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int
) {
  accessTokens(
    after: $after,
    before: $before,
    first: $first,
    last: $last
  ) {
    edges {
      ...AccessTokenEdgeFragment
    }
    nodes {
      ...AccessTokenFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "xyz789",
  "before": "xyz789",
  "first": 123,
  "last": 123
}
Response
{
  "data": {
    "accessTokens": {
      "edges": [AccessTokenEdge],
      "nodes": [AccessToken],
      "pageInfo": PageInfo
    }
  }
}

accountBySlug

Response

Returns an Account

Arguments
Name Description
slug - String! slug of the account

Example

Query
query accountBySlug($slug: String!) {
  accountBySlug(slug: $slug) {
    accessTokens {
      ...AccessTokenConnectionFragment
    }
    createdAt
    graphs {
      ...GraphConnectionFragment
    }
    id
    name
    plan
    slug
    status {
      ...AccountStatusFragment
    }
    usage {
      ...AccountUsageTimeSeriesFragment
    }
  }
}
Variables
{"slug": "xyz789"}
Response
{
  "data": {
    "accountBySlug": {
      "accessTokens": AccessTokenConnection,
      "createdAt": "2007-12-03T10:15:30Z",
      "graphs": GraphConnection,
      "id": "4",
      "name": "xyz789",
      "plan": "TRIAL",
      "slug": "xyz789",
      "status": AccountStatus,
      "usage": AccountUsageTimeSeries
    }
  }
}

accountCreationValidate

Response

Returns an AccountCreationValidatePayload!

Arguments
Name Description
input - AccountCreationValidateInput!

Example

Query
query accountCreationValidate($input: AccountCreationValidateInput!) {
  accountCreationValidate(input: $input) {
    slugAvailable
  }
}
Variables
{"input": AccountCreationValidateInput}
Response
{"data": {"accountCreationValidate": {"slugAvailable": false}}}

branch

Description

Get branch by account slug, graph slug and the name of the branch.

Response

Returns a Branch

Arguments
Name Description
name - String name of the branch
accountSlug - String slug of the account
graphSlug - String slug of the graph

Example

Query
query branch(
  $name: String,
  $accountSlug: String,
  $graphSlug: String
) {
  branch(
    name: $name,
    accountSlug: $accountSlug,
    graphSlug: $graphSlug
  ) {
    activeDeployment {
      ...DeploymentFragment
    }
    analytics {
      ...GraphAnalyticsFragment
    }
    deployments {
      ...DeploymentConnectionFragment
    }
    domains
    endpointConfig {
      ...EndpointConfigFragment
    }
    environment
    federatedSchema
    graph {
      ...GraphFragment
    }
    id
    latestDeployment {
      ...DeploymentFragment
    }
    name
    operationChecksEnabled
    operationChecksIgnoreUsageData
    schema
    schemaProposals {
      ...SchemaProposalConnectionFragment
    }
    schemaProposalsConfiguration {
      ...SchemaProposalsConfigurationFragment
    }
    subgraphs {
      ...SubgraphFragment
    }
  }
}
Variables
{
  "name": "abc123",
  "accountSlug": "abc123",
  "graphSlug": "abc123"
}
Response
{
  "data": {
    "branch": {
      "activeDeployment": Deployment,
      "analytics": GraphAnalytics,
      "deployments": DeploymentConnection,
      "domains": ["abc123"],
      "endpointConfig": EndpointConfig,
      "environment": "PREVIEW",
      "federatedSchema": "abc123",
      "graph": Graph,
      "id": 4,
      "latestDeployment": Deployment,
      "name": "abc123",
      "operationChecksEnabled": false,
      "operationChecksIgnoreUsageData": true,
      "schema": "xyz789",
      "schemaProposals": SchemaProposalConnection,
      "schemaProposalsConfiguration": SchemaProposalsConfiguration,
      "subgraphs": [Subgraph]
    }
  }
}

deployment

Description

Get deployment by ID.

Response

Returns a Deployment

Arguments
Name Description
id - ID! ID of the deployment

Example

Query
query deployment($id: ID!) {
  deployment(id: $id) {
    apiSchema
    apiSchemaDiff {
      ...DiffSnippetFragment
    }
    branch {
      ...BranchFragment
    }
    changeCounts {
      ...DeploymentChangeCountsFragment
    }
    compositionInputs {
      ...DeploymentSubgraphFragment
    }
    createdAt
    duration
    federatedSdl
    finishedAt
    id
    isRedeployable
    message
    schemaVersion {
      ...SchemaVersionFragment
    }
    startedAt
    status
    steps {
      ...DeploymentStepFragment
    }
    subgraph {
      ...DeploymentSubgraphFragment
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "deployment": {
      "apiSchema": "abc123",
      "apiSchemaDiff": [DiffSnippet],
      "branch": Branch,
      "changeCounts": DeploymentChangeCounts,
      "compositionInputs": [DeploymentSubgraph],
      "createdAt": "2007-12-03T10:15:30Z",
      "duration": 987,
      "federatedSdl": "abc123",
      "finishedAt": "2007-12-03T10:15:30Z",
      "id": 4,
      "isRedeployable": false,
      "message": "xyz789",
      "schemaVersion": SchemaVersion,
      "startedAt": "2007-12-03T10:15:30Z",
      "status": "QUEUED",
      "steps": [DeploymentStep],
      "subgraph": DeploymentSubgraph
    }
  }
}

extensionByName

Response

Returns an Extension

Arguments
Name Description
name - String!

Example

Query
query extensionByName($name: String!) {
  extensionByName(name: $name) {
    highestVersion {
      ...ExtensionVersionFragment
    }
    id
    name
    owners {
      ...UserFragment
    }
    versions {
      ...ExtensionVersionFragment
    }
  }
}
Variables
{"name": "abc123"}
Response
{
  "data": {
    "extensionByName": {
      "highestVersion": ExtensionVersion,
      "id": 4,
      "name": "xyz789",
      "owners": [User],
      "versions": [ExtensionVersion]
    }
  }
}

extensionVersionByNameAndVersion

Response

Returns an ExtensionVersion

Arguments
Name Description
version - SemverVersion!
extensionName - String!

Example

Query
query extensionVersionByNameAndVersion(
  $version: SemverVersion!,
  $extensionName: String!
) {
  extensionVersionByNameAndVersion(
    version: $version,
    extensionName: $extensionName
  ) {
    createdAt
    defaultPermissions
    definitionsSdl
    description
    extension {
      ...ExtensionFragment
    }
    homepageUrl
    kind
    license
    minimumCompatibleGatewayVersion
    publishedBy {
      ...UserFragment
    }
    readme
    repositoryUrl
    sdkVersion
    sdl
    version
  }
}
Variables
{
  "version": SemverVersion,
  "extensionName": "xyz789"
}
Response
{
  "data": {
    "extensionVersionByNameAndVersion": {
      "createdAt": "2007-12-03T10:15:30Z",
      "defaultPermissions": ["NETWORK"],
      "definitionsSdl": "xyz789",
      "description": "xyz789",
      "extension": Extension,
      "homepageUrl": Url,
      "kind": "FIELD_RESOLVER",
      "license": "xyz789",
      "minimumCompatibleGatewayVersion": SemverVersion,
      "publishedBy": User,
      "readme": "xyz789",
      "repositoryUrl": Url,
      "sdkVersion": SemverVersion,
      "sdl": "xyz789",
      "version": SemverVersion
    }
  }
}

extensionVersionsByVersionRequirement

Description

Looks for extension versions that match the requirements.

The results are returned in the same order as the requirements.

Response

Returns [ExtensionVersionMatch!]

Arguments
Name Description
requirements - [ExtensionVersionRequirement!]!

Example

Query
query extensionVersionsByVersionRequirement($requirements: [ExtensionVersionRequirement!]!) {
  extensionVersionsByVersionRequirement(requirements: $requirements) {
    ... on ExtensionDoesNotExistError {
      ...ExtensionDoesNotExistErrorFragment
    }
    ... on ExtensionVersion {
      ...ExtensionVersionFragment
    }
    ... on ExtensionVersionDoesNotExistError {
      ...ExtensionVersionDoesNotExistErrorFragment
    }
  }
}
Variables
{"requirements": [ExtensionVersionRequirement]}
Response
{
  "data": {
    "extensionVersionsByVersionRequirement": [
      ExtensionDoesNotExistError
    ]
  }
}

extensions

Response

Returns an ExtensionConnection!

Arguments
Name Description
after - String
first - Int
filter - ExtensionFilter

Example

Query
query extensions(
  $after: String,
  $first: Int,
  $filter: ExtensionFilter
) {
  extensions(
    after: $after,
    first: $first,
    filter: $filter
  ) {
    edges {
      ...ExtensionEdgeFragment
    }
    nodes {
      ...ExtensionFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "abc123",
  "first": 987,
  "filter": ExtensionFilter
}
Response
{
  "data": {
    "extensions": {
      "edges": [ExtensionEdge],
      "nodes": [Extension],
      "pageInfo": PageInfo
    }
  }
}

graphByAccountSlug

Description

Get a graph by account slug and slug of the graph itself.

Response

Returns a Graph

Arguments
Name Description
accountSlug - String! slug of the account
graphSlug - String! slug of the graph

Example

Query
query graphByAccountSlug(
  $accountSlug: String!,
  $graphSlug: String!
) {
  graphByAccountSlug(
    accountSlug: $accountSlug,
    graphSlug: $graphSlug
  ) {
    account {
      ...AccountFragment
    }
    analytics {
      ...GraphAnalyticsFragment
    }
    branch {
      ...BranchFragment
    }
    branches {
      ...BranchConnectionFragment
    }
    createdAt
    customCheckWebhooks {
      ...CustomCheckWebhookFragment
    }
    id
    operationChecksConfiguration {
      ...GraphOperationCheckConfigurationFragment
    }
    owners {
      ...TeamFragment
    }
    productionBranch {
      ...BranchFragment
    }
    request {
      ...RequestFragment
    }
    requests {
      ...RequestConnectionFragment
    }
    schemaChecks {
      ...SchemaCheckConnectionFragment
    }
    schemaProposals {
      ...SchemaProposalConnectionFragment
    }
    slug
  }
}
Variables
{
  "accountSlug": "xyz789",
  "graphSlug": "abc123"
}
Response
{
  "data": {
    "graphByAccountSlug": {
      "account": Account,
      "analytics": GraphAnalytics,
      "branch": Branch,
      "branches": BranchConnection,
      "createdAt": "2007-12-03T10:15:30Z",
      "customCheckWebhooks": [CustomCheckWebhook],
      "id": 4,
      "operationChecksConfiguration": GraphOperationCheckConfiguration,
      "owners": [Team],
      "productionBranch": Branch,
      "request": Request,
      "requests": RequestConnection,
      "schemaChecks": SchemaCheckConnection,
      "schemaProposals": SchemaProposalConnection,
      "slug": "abc123"
    }
  }
}

invite

Response

Returns an Invite

Arguments
Name Description
id - ID!

Example

Query
query invite($id: ID!) {
  invite(id: $id) {
    createdAt
    email
    id
    invitedBy {
      ...UserFragment
    }
    lastRenewedAt
    organization {
      ...OrganizationFragment
    }
    role
    status
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "invite": {
      "createdAt": "2007-12-03T10:15:30Z",
      "email": "abc123",
      "id": "4",
      "invitedBy": User,
      "lastRenewedAt": "2007-12-03T10:15:30Z",
      "organization": Organization,
      "role": "OWNER",
      "status": "PENDING"
    }
  }
}

node

Response

Returns a Node

Arguments
Name Description
id - ID!

Example

Query
query node($id: ID!) {
  node(id: $id) {
    id
  }
}
Variables
{"id": "4"}
Response
{"data": {"node": {"id": "4"}}}

notificationsInbox

Description

Return the notifications inbox of the currently connected user.

Response

Returns a NotificationsInbox

Example

Query
query notificationsInbox {
  notificationsInbox {
    messages {
      ...InboxMessageFragment
    }
  }
}
Response
{
  "data": {
    "notificationsInbox": {"messages": [InboxMessage]}
  }
}

schemaCheck

Response

Returns a SchemaCheck

Arguments
Name Description
id - ID!

Example

Query
query schemaCheck($id: ID!) {
  schemaCheck(id: $id) {
    compositionCheckErrors {
      ...CompositionCheckErrorFragment
    }
    createdAt
    diagnostics {
      ...SchemaCheckDiagnosticFragment
    }
    errorCount
    gitCommit {
      ...SchemaCheckGitCommitFragment
    }
    id
    lintCheckErrors {
      ...LintCheckErrorFragment
    }
    operationCheckErrors {
      ...OperationCheckErrorFragment
    }
    proposalCheckErrors {
      ...ProposalCheckErrorFragment
    }
    schema
    subgraphName
    validationCheckErrors {
      ...ValidationCheckErrorFragment
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "schemaCheck": {
      "compositionCheckErrors": [CompositionCheckError],
      "createdAt": "2007-12-03T10:15:30Z",
      "diagnostics": [SchemaCheckDiagnostic],
      "errorCount": 123,
      "gitCommit": SchemaCheckGitCommit,
      "id": 4,
      "lintCheckErrors": [LintCheckError],
      "operationCheckErrors": [OperationCheckError],
      "proposalCheckErrors": [ProposalCheckError],
      "schema": "xyz789",
      "subgraphName": "xyz789",
      "validationCheckErrors": [ValidationCheckError]
    }
  }
}

schemaProposal

Response

Returns a SchemaProposal

Arguments
Name Description
id - ID!

Example

Query
query schemaProposal($id: ID!) {
  schemaProposal(id: $id) {
    activityFeed {
      ...SchemaProposalActivityFeedItemFragment
    }
    author {
      ...UserFragment
    }
    branch {
      ...BranchFragment
    }
    comments {
      ...SchemaProposalCommentFragment
    }
    createdAt
    description
    id
    reviewers {
      ... on SchemaProposalReviewerTeam {
        ...SchemaProposalReviewerTeamFragment
      }
      ... on SchemaProposalReviewerUser {
        ...SchemaProposalReviewerUserFragment
      }
    }
    revision
    status
    subgraph {
      ...SchemaProposalSubgraphFragment
    }
    subgraphs {
      ...SchemaProposalSubgraphFragment
    }
    title
    viewerIsReviewer
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "schemaProposal": {
      "activityFeed": [SchemaProposalActivityFeedItem],
      "author": User,
      "branch": Branch,
      "comments": [SchemaProposalComment],
      "createdAt": "2007-12-03T10:15:30Z",
      "description": "xyz789",
      "id": 4,
      "reviewers": [SchemaProposalReviewerTeam],
      "revision": 987,
      "status": "APPROVED",
      "subgraph": SchemaProposalSubgraph,
      "subgraphs": [SchemaProposalSubgraph],
      "title": "xyz789",
      "viewerIsReviewer": true
    }
  }
}

schemaVersion

Response

Returns a SchemaVersion

Arguments
Name Description
id - ID!

Example

Query
query schemaVersion($id: ID!) {
  schemaVersion(id: $id) {
    changes {
      ...SchemaVersionChangeConnectionFragment
    }
    createdAt
    delta {
      ...SchemaVersionDeltaFragment
    }
    id
    message
    schema
    subgraph {
      ...SubgraphFragment
    }
  }
}
Variables
{"id": 4}
Response
{
  "data": {
    "schemaVersion": {
      "changes": SchemaVersionChangeConnection,
      "createdAt": "2007-12-03T10:15:30Z",
      "delta": SchemaVersionDelta,
      "id": 4,
      "message": "xyz789",
      "schema": "abc123",
      "subgraph": Subgraph
    }
  }
}

schemaVersions

Response

Returns a SchemaVersionConnection!

Arguments
Name Description
after - String
before - String
first - Int
last - Int
accountSlug - String! account slug
graphSlug - String graph slug
branch - String name of the branch
subgraphName - String name of the subgraph
populated - Boolean! return only versions with changes. Default = true

Example

Query
query schemaVersions(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int,
  $accountSlug: String!,
  $graphSlug: String,
  $branch: String,
  $subgraphName: String,
  $populated: Boolean!
) {
  schemaVersions(
    after: $after,
    before: $before,
    first: $first,
    last: $last,
    accountSlug: $accountSlug,
    graphSlug: $graphSlug,
    branch: $branch,
    subgraphName: $subgraphName,
    populated: $populated
  ) {
    edges {
      ...SchemaVersionEdgeFragment
    }
    nodes {
      ...SchemaVersionFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{
  "after": "xyz789",
  "before": "xyz789",
  "first": 123,
  "last": 123,
  "accountSlug": "abc123",
  "graphSlug": "abc123",
  "branch": "xyz789",
  "subgraphName": "abc123",
  "populated": true
}
Response
{
  "data": {
    "schemaVersions": {
      "edges": [SchemaVersionEdge],
      "nodes": [SchemaVersion],
      "pageInfo": PageInfo
    }
  }
}

subgraph

Description

Get subgraph.

Response

Returns a Subgraph

Arguments
Name Description
accountSlug - String! account slug
graphSlug - String graph slug
branch - String name of the branch
subgraphName - String! name of the subgraph

Example

Query
query subgraph(
  $accountSlug: String!,
  $graphSlug: String,
  $branch: String,
  $subgraphName: String!
) {
  subgraph(
    accountSlug: $accountSlug,
    graphSlug: $graphSlug,
    branch: $branch,
    subgraphName: $subgraphName
  ) {
    createdAt
    name
    owners {
      ...TeamFragment
    }
    schema
    updatedAt
    url
  }
}
Variables
{
  "accountSlug": "xyz789",
  "graphSlug": "xyz789",
  "branch": "abc123",
  "subgraphName": "abc123"
}
Response
{
  "data": {
    "subgraph": {
      "createdAt": "2007-12-03T10:15:30Z",
      "name": "xyz789",
      "owners": [Team],
      "schema": "abc123",
      "updatedAt": "2007-12-03T10:15:30Z",
      "url": "abc123"
    }
  }
}

team

Response

Returns a Team

Arguments
Name Description
id - ID!

Example

Query
query team($id: ID!) {
  team(id: $id) {
    id
    members {
      ...UserConnectionFragment
    }
    name
    parent {
      ...TeamFragment
    }
    parentTeamId
    query {
      ...QueryFragment
    }
    slug
    subteams {
      ...TeamConnectionFragment
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "team": {
      "id": "4",
      "members": UserConnection,
      "name": "xyz789",
      "parent": Team,
      "parentTeamId": 4,
      "query": Query,
      "slug": "abc123",
      "subteams": TeamConnection
    }
  }
}

teamBySlug

Response

Returns a Team

Arguments
Name Description
slug - String!
organizationSlug - String!

Example

Query
query teamBySlug(
  $slug: String!,
  $organizationSlug: String!
) {
  teamBySlug(
    slug: $slug,
    organizationSlug: $organizationSlug
  ) {
    id
    members {
      ...UserConnectionFragment
    }
    name
    parent {
      ...TeamFragment
    }
    parentTeamId
    query {
      ...QueryFragment
    }
    slug
    subteams {
      ...TeamConnectionFragment
    }
  }
}
Variables
{
  "slug": "abc123",
  "organizationSlug": "abc123"
}
Response
{
  "data": {
    "teamBySlug": {
      "id": 4,
      "members": UserConnection,
      "name": "abc123",
      "parent": Team,
      "parentTeamId": "4",
      "query": Query,
      "slug": "abc123",
      "subteams": TeamConnection
    }
  }
}

viewer

Description

Give the actual connected user.

Response

Returns a User

Example

Query
query viewer {
  viewer {
    avatarUrl
    canStartNewTrial
    createdAt
    email
    id
    name
    organizationMemberships {
      ...MemberFragment
    }
    organizations {
      ...OrganizationConnectionFragment
    }
  }
}
Response
{
  "data": {
    "viewer": {
      "avatarUrl": "xyz789",
      "canStartNewTrial": false,
      "createdAt": "2007-12-03T10:15:30Z",
      "email": "xyz789",
      "id": "4",
      "name": "abc123",
      "organizationMemberships": [Member],
      "organizations": OrganizationConnection
    }
  }
}

zitadelStatus

Response

Returns a ZitadelStatus

Example

Query
query zitadelStatus {
  zitadelStatus {
    clientId
    idp
    organizationId
    redirect
    resources
  }
}
Response
{
  "data": {
    "zitadelStatus": {
      "clientId": "abc123",
      "idp": false,
      "organizationId": "xyz789",
      "redirect": false,
      "resources": false
    }
  }
}

Mutations

accessTokenCreate

Description

Create a new access token.

Response

Returns an AccessTokenCreatePayload!

Arguments
Name Description
input - AccessTokenCreateInput!

Example

Query
mutation accessTokenCreate($input: AccessTokenCreateInput!) {
  accessTokenCreate(input: $input) {
    ... on AccessTokenCreateSuccess {
      ...AccessTokenCreateSuccessFragment
    }
    ... on AccountIdMissingForAccountAccessTokenError {
      ...AccountIdMissingForAccountAccessTokenErrorFragment
    }
    ... on CouldNotFindGraphsError {
      ...CouldNotFindGraphsErrorFragment
    }
    ... on GraphScopeLimitExceededError {
      ...GraphScopeLimitExceededErrorFragment
    }
    ... on InvalidAccountError {
      ...InvalidAccountErrorFragment
    }
    ... on TokenLimitExceededError {
      ...TokenLimitExceededErrorFragment
    }
    ... on UserAccessTokensCannotBeScopedToAGraphError {
      ...UserAccessTokensCannotBeScopedToAGraphErrorFragment
    }
  }
}
Variables
{"input": AccessTokenCreateInput}
Response
{"data": {"accessTokenCreate": AccessTokenCreateSuccess}}

accessTokenDelete

Description

Delete a given access token.

Response

Returns an AccessTokenDeletePayload!

Arguments
Name Description
input - AccessTokenDeleteInput!

Example

Query
mutation accessTokenDelete($input: AccessTokenDeleteInput!) {
  accessTokenDelete(input: $input) {
    ... on AccessTokenDeleteSuccess {
      ...AccessTokenDeleteSuccessFragment
    }
    ... on TokenDoesNotExistError {
      ...TokenDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": AccessTokenDeleteInput}
Response
{"data": {"accessTokenDelete": AccessTokenDeleteSuccess}}

branchCreate

Response

Returns a BranchCreatePayload!

Arguments
Name Description
input - BranchCreateInput!

Example

Query
mutation branchCreate($input: BranchCreateInput!) {
  branchCreate(input: $input) {
    ... on BranchAlreadyExistsError {
      ...BranchAlreadyExistsErrorFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on GraphNotSelfHostedError {
      ...GraphNotSelfHostedErrorFragment
    }
    ... on Query {
      ...QueryFragment
    }
  }
}
Variables
{"input": BranchCreateInput}
Response
{"data": {"branchCreate": BranchAlreadyExistsError}}

branchDelete

Response

Returns a BranchDeletePayload!

Arguments
Name Description
accountSlug - String! slug of the account
graphSlug - String slug of the graph
branchName - String! name of the branch

Example

Query
mutation branchDelete(
  $accountSlug: String!,
  $graphSlug: String,
  $branchName: String!
) {
  branchDelete(
    accountSlug: $accountSlug,
    graphSlug: $graphSlug,
    branchName: $branchName
  ) {
    ... on BranchDoesNotExistError {
      ...BranchDoesNotExistErrorFragment
    }
    ... on CannotDeleteProductionBranchError {
      ...CannotDeleteProductionBranchErrorFragment
    }
    ... on Query {
      ...QueryFragment
    }
  }
}
Variables
{
  "accountSlug": "xyz789",
  "graphSlug": "abc123",
  "branchName": "xyz789"
}
Response
{"data": {"branchDelete": BranchDoesNotExistError}}

branchSchemaProposalsConfiguredReviewerAdd

Example

Query
mutation branchSchemaProposalsConfiguredReviewerAdd($input: SchemaProposalsConfiguredReviewerAddInput!) {
  branchSchemaProposalsConfiguredReviewerAdd(input: $input) {
    ... on AlreadyExistsError {
      ...AlreadyExistsErrorFragment
    }
    ... on BranchDoesNotExistError {
      ...BranchDoesNotExistErrorFragment
    }
    ... on SchemaProposalsConfiguredReviewerAddSuccess {
      ...SchemaProposalsConfiguredReviewerAddSuccessFragment
    }
    ... on TeamDoesNotExistError {
      ...TeamDoesNotExistErrorFragment
    }
    ... on UserDoesNotExistError {
      ...UserDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": SchemaProposalsConfiguredReviewerAddInput}
Response
{
  "data": {
    "branchSchemaProposalsConfiguredReviewerAdd": AlreadyExistsError
  }
}

branchSchemaProposalsConfiguredReviewerRemove

Example

Query
mutation branchSchemaProposalsConfiguredReviewerRemove($input: SchemaProposalsConfiguredReviewerRemoveInput!) {
  branchSchemaProposalsConfiguredReviewerRemove(input: $input) {
    ... on BranchDoesNotExistError {
      ...BranchDoesNotExistErrorFragment
    }
    ... on ReviewerDoesNotExistError {
      ...ReviewerDoesNotExistErrorFragment
    }
    ... on SchemaProposalsConfiguredReviewerRemoveSuccess {
      ...SchemaProposalsConfiguredReviewerRemoveSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalsConfiguredReviewerRemoveInput}
Response
{
  "data": {
    "branchSchemaProposalsConfiguredReviewerRemove": BranchDoesNotExistError
  }
}

branchUpdate

Response

Returns a BranchUpdatePayload!

Arguments
Name Description
input - BranchUpdateInput!

Example

Query
mutation branchUpdate($input: BranchUpdateInput!) {
  branchUpdate(input: $input) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on Query {
      ...QueryFragment
    }
  }
}
Variables
{"input": BranchUpdateInput}
Response
{"data": {"branchUpdate": GraphDoesNotExistError}}

deleteSubgraph

Description

Delete a subgraph

Response

Returns a DeleteSubgraphPayload!

Arguments
Name Description
input - DeleteSubgraphInput!

Example

Query
mutation deleteSubgraph($input: DeleteSubgraphInput!) {
  deleteSubgraph(input: $input) {
    ... on DeleteSubgraphDeploymentFailure {
      ...DeleteSubgraphDeploymentFailureFragment
    }
    ... on DeleteSubgraphSuccess {
      ...DeleteSubgraphSuccessFragment
    }
    ... on FederatedGraphCompositionError {
      ...FederatedGraphCompositionErrorFragment
    }
    ... on GraphBranchDoesNotExistError {
      ...GraphBranchDoesNotExistErrorFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on GraphNotFederatedError {
      ...GraphNotFederatedErrorFragment
    }
    ... on SubgraphNotFoundError {
      ...SubgraphNotFoundErrorFragment
    }
  }
}
Variables
{"input": DeleteSubgraphInput}
Response
{
  "data": {
    "deleteSubgraph": DeleteSubgraphDeploymentFailure
  }
}

endpointConfigUpdate

Response

Returns an EndpointConfigUpdatePayload!

Arguments
Name Description
input - EndpointConfigUpdateInput!

Example

Query
mutation endpointConfigUpdate($input: EndpointConfigUpdateInput!) {
  endpointConfigUpdate(input: $input) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on Query {
      ...QueryFragment
    }
  }
}
Variables
{"input": EndpointConfigUpdateInput}
Response
{"data": {"endpointConfigUpdate": GraphDoesNotExistError}}

extensionAddOwner

Response

Returns an ExtensionAddOwnerPayload

Arguments
Name Description
extensionName - String!
userId - ID!

Example

Query
mutation extensionAddOwner(
  $extensionName: String!,
  $userId: ID!
) {
  extensionAddOwner(
    extensionName: $extensionName,
    userId: $userId
  ) {
    ... on ExtensionAddOwnerSuccess {
      ...ExtensionAddOwnerSuccessFragment
    }
    ... on ExtensionDoesNotExistError {
      ...ExtensionDoesNotExistErrorFragment
    }
    ... on ExtensionUnauthorized {
      ...ExtensionUnauthorizedFragment
    }
  }
}
Variables
{"extensionName": "abc123", "userId": 4}
Response
{"data": {"extensionAddOwner": ExtensionAddOwnerSuccess}}

extensionPublish

Description

Publish a version of an extension to the registry. If the extension does not already exist, it will be created.

Response

Returns an ExtensionPublishPayload

Arguments
Name Description
manifest - VersionedExtensionManifest!
wasmModule - Upload!

Example

Query
mutation extensionPublish(
  $manifest: VersionedExtensionManifest!,
  $wasmModule: Upload!
) {
  extensionPublish(
    manifest: $manifest,
    wasmModule: $wasmModule
  ) {
    ... on BadWasmModuleError {
      ...BadWasmModuleErrorFragment
    }
    ... on ExtensionPublishSuccess {
      ...ExtensionPublishSuccessFragment
    }
    ... on ExtensionUnauthorized {
      ...ExtensionUnauthorizedFragment
    }
    ... on ExtensionValidationError {
      ...ExtensionValidationErrorFragment
    }
    ... on ExtensionVersionAlreadyExistsError {
      ...ExtensionVersionAlreadyExistsErrorFragment
    }
  }
}
Variables
{
  "manifest": VersionedExtensionManifest,
  "wasmModule": Upload
}
Response
{"data": {"extensionPublish": BadWasmModuleError}}

extensionRemoveOwner

Response

Returns an ExtensionRemoveOwnerPayload

Arguments
Name Description
extensionName - String!
userId - ID!

Example

Query
mutation extensionRemoveOwner(
  $extensionName: String!,
  $userId: ID!
) {
  extensionRemoveOwner(
    extensionName: $extensionName,
    userId: $userId
  ) {
    ... on ExtensionDoesNotExistError {
      ...ExtensionDoesNotExistErrorFragment
    }
    ... on ExtensionRemoveOwnerSuccess {
      ...ExtensionRemoveOwnerSuccessFragment
    }
    ... on ExtensionUnauthorized {
      ...ExtensionUnauthorizedFragment
    }
  }
}
Variables
{
  "extensionName": "abc123",
  "userId": "4"
}
Response
{
  "data": {
    "extensionRemoveOwner": ExtensionDoesNotExistError
  }
}

graphAddOwner

Response

Returns a GraphAddOwnerPayload!

Arguments
Name Description
graphId - ID!
ownerId - ID!

Example

Query
mutation graphAddOwner(
  $graphId: ID!,
  $ownerId: ID!
) {
  graphAddOwner(
    graphId: $graphId,
    ownerId: $ownerId
  ) {
    ... on GraphAddOwnerSuccess {
      ...GraphAddOwnerSuccessFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on NotAllowedError {
      ...NotAllowedErrorFragment
    }
  }
}
Variables
{
  "graphId": "4",
  "ownerId": "4"
}
Response
{"data": {"graphAddOwner": GraphAddOwnerSuccess}}

graphCreate

Description

Create a new graph without any source for an initial deployment.

Response

Returns a GraphCreatePayload!

Arguments
Name Description
input - GraphCreateInput!

Example

Query
mutation graphCreate($input: GraphCreateInput!) {
  graphCreate(input: $input) {
    ... on AccountDoesNotExistError {
      ...AccountDoesNotExistErrorFragment
    }
    ... on CurrentPlanLimitReachedError {
      ...CurrentPlanLimitReachedErrorFragment
    }
    ... on DisabledAccountError {
      ...DisabledAccountErrorFragment
    }
    ... on GraphCreateSuccess {
      ...GraphCreateSuccessFragment
    }
    ... on ManagedGraphsNoLongerSupportedError {
      ...ManagedGraphsNoLongerSupportedErrorFragment
    }
    ... on SlugAlreadyExistsError {
      ...SlugAlreadyExistsErrorFragment
    }
    ... on SlugInvalidError {
      ...SlugInvalidErrorFragment
    }
    ... on SlugTooLongError {
      ...SlugTooLongErrorFragment
    }
    ... on StandaloneGraphsNoLongerSupportedError {
      ...StandaloneGraphsNoLongerSupportedErrorFragment
    }
  }
}
Variables
{"input": GraphCreateInput}
Response
{"data": {"graphCreate": AccountDoesNotExistError}}

graphDelete

Response

Returns a GraphDeletePayload!

Arguments
Name Description
input - GraphDeleteInput!

Example

Query
mutation graphDelete($input: GraphDeleteInput!) {
  graphDelete(input: $input) {
    ... on GraphDeleteSuccess {
      ...GraphDeleteSuccessFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on NotAllowedError {
      ...NotAllowedErrorFragment
    }
  }
}
Variables
{"input": GraphDeleteInput}
Response
{"data": {"graphDelete": GraphDeleteSuccess}}

graphOperationCheckConfigurationUpdate

Arguments
Name Description
input - GraphOperationCheckConfigurationInput!

Example

Query
mutation graphOperationCheckConfigurationUpdate($input: GraphOperationCheckConfigurationInput!) {
  graphOperationCheckConfigurationUpdate(input: $input) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on GraphOperationCheckConfiguration {
      ...GraphOperationCheckConfigurationFragment
    }
    ... on NotAllowedError {
      ...NotAllowedErrorFragment
    }
  }
}
Variables
{"input": GraphOperationCheckConfigurationInput}
Response
{
  "data": {
    "graphOperationCheckConfigurationUpdate": GraphDoesNotExistError
  }
}

graphRemoveOwner

Response

Returns a GraphRemoveOwnerPayload!

Arguments
Name Description
graphId - ID!
ownerId - ID!

Example

Query
mutation graphRemoveOwner(
  $graphId: ID!,
  $ownerId: ID!
) {
  graphRemoveOwner(
    graphId: $graphId,
    ownerId: $ownerId
  ) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on GraphRemoveOwnerSuccess {
      ...GraphRemoveOwnerSuccessFragment
    }
    ... on NotAllowedError {
      ...NotAllowedErrorFragment
    }
  }
}
Variables
{"graphId": 4, "ownerId": "4"}
Response
{"data": {"graphRemoveOwner": GraphDoesNotExistError}}

graphUpdate

Response

Returns a GraphUpdatePayload!

Arguments
Name Description
input - GraphUpdateInput!

Example

Query
mutation graphUpdate($input: GraphUpdateInput!) {
  graphUpdate(input: $input) {
    ... on CannotBeRenamedError {
      ...CannotBeRenamedErrorFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on GraphUpdateSuccess {
      ...GraphUpdateSuccessFragment
    }
    ... on NotAllowedError {
      ...NotAllowedErrorFragment
    }
    ... on SlugAlreadyExistsError {
      ...SlugAlreadyExistsErrorFragment
    }
    ... on SlugInvalidError {
      ...SlugInvalidErrorFragment
    }
    ... on SlugTooLongError {
      ...SlugTooLongErrorFragment
    }
  }
}
Variables
{"input": GraphUpdateInput}
Response
{"data": {"graphUpdate": CannotBeRenamedError}}

inviteAccept

Response

Returns an InviteAcceptPayload!

Arguments
Name Description
input - InviteAcceptInput!

Example

Query
mutation inviteAccept($input: InviteAcceptInput!) {
  inviteAccept(input: $input) {
    ... on AlreadyMemberError {
      ...AlreadyMemberErrorFragment
    }
    ... on CannotUseInvitationsWithSso {
      ...CannotUseInvitationsWithSsoFragment
    }
    ... on InviteAcceptSuccess {
      ...InviteAcceptSuccessFragment
    }
    ... on InviteDoesNotExistError {
      ...InviteDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": InviteAcceptInput}
Response
{"data": {"inviteAccept": AlreadyMemberError}}

inviteCancel

Response

Returns an InviteCancelPayload!

Arguments
Name Description
input - InviteCancelInput!

Example

Query
mutation inviteCancel($input: InviteCancelInput!) {
  inviteCancel(input: $input) {
    ... on InviteCancelSuccess {
      ...InviteCancelSuccessFragment
    }
    ... on InviteDoesNotExistError {
      ...InviteDoesNotExistErrorFragment
    }
    ... on NotAllowedToCancelInvitesError {
      ...NotAllowedToCancelInvitesErrorFragment
    }
  }
}
Variables
{"input": InviteCancelInput}
Response
{"data": {"inviteCancel": InviteCancelSuccess}}

inviteDecline

Response

Returns an InviteDeclinePayload!

Arguments
Name Description
input - InviteDeclineInput!

Example

Query
mutation inviteDecline($input: InviteDeclineInput!) {
  inviteDecline(input: $input) {
    ... on InviteDeclineSuccess {
      ...InviteDeclineSuccessFragment
    }
    ... on InviteDoesNotExistError {
      ...InviteDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": InviteDeclineInput}
Response
{"data": {"inviteDecline": InviteDeclineSuccess}}

inviteSend

Response

Returns an InviteSendPayload!

Arguments
Name Description
input - InviteSendInput!

Example

Query
mutation inviteSend($input: InviteSendInput!) {
  inviteSend(input: $input) {
    ... on CannotUseInvitationsWithSso {
      ...CannotUseInvitationsWithSsoFragment
    }
    ... on InvalidEmailAddressError {
      ...InvalidEmailAddressErrorFragment
    }
    ... on InviteSendSuccess {
      ...InviteSendSuccessFragment
    }
    ... on NotAllowedToSendInvitesError {
      ...NotAllowedToSendInvitesErrorFragment
    }
    ... on OrganizationDoesNotExistError {
      ...OrganizationDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": InviteSendInput}
Response
{"data": {"inviteSend": CannotUseInvitationsWithSso}}

memberDelete

Description

Remove member from an organization

Response

Returns a MemberDeletePayload!

Arguments
Name Description
input - MemberDeleteInput!

Example

Query
mutation memberDelete($input: MemberDeleteInput!) {
  memberDelete(input: $input) {
    deletedMemberId
    query {
      ...QueryFragment
    }
  }
}
Variables
{"input": MemberDeleteInput}
Response
{
  "data": {
    "memberDelete": {"deletedMemberId": 4, "query": Query}
  }
}

memberUpdate

Description

Update role of an organization member

Response

Returns a MemberUpdatePayload!

Arguments
Name Description
input - MemberUpdateInput!

Example

Query
mutation memberUpdate($input: MemberUpdateInput!) {
  memberUpdate(input: $input) {
    member {
      ...MemberFragment
    }
    query {
      ...QueryFragment
    }
  }
}
Variables
{"input": MemberUpdateInput}
Response
{
  "data": {
    "memberUpdate": {
      "member": Member,
      "query": Query
    }
  }
}

notificationsMarkAsRead

Response

Returns a NotificationsMarkAsReadPayload!

Arguments
Name Description
notificationIds - [ID!]!

Example

Query
mutation notificationsMarkAsRead($notificationIds: [ID!]!) {
  notificationsMarkAsRead(notificationIds: $notificationIds) {
    ... on NotificationsMarkAsReadSuccess {
      ...NotificationsMarkAsReadSuccessFragment
    }
  }
}
Variables
{"notificationIds": [4]}
Response
{
  "data": {
    "notificationsMarkAsRead": NotificationsMarkAsReadSuccess
  }
}

organizationCreate

Description

Create new organization account owned by the current user. Slug must be unique.

Response

Returns an OrganizationCreatePayload!

Arguments
Name Description
input - OrganizationCreateInput!

Example

Query
mutation organizationCreate($input: OrganizationCreateInput!) {
  organizationCreate(input: $input) {
    ... on NameSizeCheckError {
      ...NameSizeCheckErrorFragment
    }
    ... on OrganizationCreateSuccess {
      ...OrganizationCreateSuccessFragment
    }
    ... on ReservedSlugsCheckError {
      ...ReservedSlugsCheckErrorFragment
    }
    ... on SlugAlreadyExistsError {
      ...SlugAlreadyExistsErrorFragment
    }
    ... on SlugError {
      ...SlugErrorFragment
    }
    ... on SlugSizeCheckError {
      ...SlugSizeCheckErrorFragment
    }
    ... on TrialPlanUnavailableError {
      ...TrialPlanUnavailableErrorFragment
    }
  }
}
Variables
{"input": OrganizationCreateInput}
Response
{"data": {"organizationCreate": NameSizeCheckError}}

organizationDelete

Response

Returns an OrganizationDeletePayload!

Arguments
Name Description
input - OrganizationDeleteInput!

Example

Query
mutation organizationDelete($input: OrganizationDeleteInput!) {
  organizationDelete(input: $input) {
    ... on NotAllowedToDeleteOrganizationError {
      ...NotAllowedToDeleteOrganizationErrorFragment
    }
    ... on OrganizationDeleteSuccess {
      ...OrganizationDeleteSuccessFragment
    }
    ... on OrganizationDoesNotExistError {
      ...OrganizationDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": OrganizationDeleteInput}
Response
{
  "data": {
    "organizationDelete": NotAllowedToDeleteOrganizationError
  }
}

organizationSlugUpdate

Response

Returns an OrganizationSlugUpdatePayload!

Arguments
Name Description
input - OrganizationSlugUpdateInput!

Example

Query
mutation organizationSlugUpdate($input: OrganizationSlugUpdateInput!) {
  organizationSlugUpdate(input: $input) {
    ... on NotAllowedToSlugUpdateError {
      ...NotAllowedToSlugUpdateErrorFragment
    }
    ... on OrganizationDoesNotExistError {
      ...OrganizationDoesNotExistErrorFragment
    }
    ... on OrganizationSlugUpdateSuccess {
      ...OrganizationSlugUpdateSuccessFragment
    }
    ... on ReservedSlugsCheckError {
      ...ReservedSlugsCheckErrorFragment
    }
    ... on SlugAlreadyExistsError {
      ...SlugAlreadyExistsErrorFragment
    }
    ... on SlugError {
      ...SlugErrorFragment
    }
    ... on SlugSizeCheckError {
      ...SlugSizeCheckErrorFragment
    }
  }
}
Variables
{"input": OrganizationSlugUpdateInput}
Response
{
  "data": {
    "organizationSlugUpdate": NotAllowedToSlugUpdateError
  }
}

organizationUpdate

Response

Returns an OrganizationUpdatePayload!

Arguments
Name Description
input - OrganizationUpdateInput!

Example

Query
mutation organizationUpdate($input: OrganizationUpdateInput!) {
  organizationUpdate(input: $input) {
    ... on NameSizeCheckError {
      ...NameSizeCheckErrorFragment
    }
    ... on NotAllowedToUpdateOrganizationError {
      ...NotAllowedToUpdateOrganizationErrorFragment
    }
    ... on OrganizationDoesNotExistError {
      ...OrganizationDoesNotExistErrorFragment
    }
    ... on OrganizationUpdateSuccess {
      ...OrganizationUpdateSuccessFragment
    }
  }
}
Variables
{"input": OrganizationUpdateInput}
Response
{"data": {"organizationUpdate": NameSizeCheckError}}

personalAccountUpdate

to be removed
Response

Returns a PersonalAccountUpdatePayload!

Arguments
Name Description
input - PersonalAccountUpdateInput!

Example

Query
mutation personalAccountUpdate($input: PersonalAccountUpdateInput!) {
  personalAccountUpdate(input: $input) {
    ... on NameSizeCheckError {
      ...NameSizeCheckErrorFragment
    }
    ... on PersonalAccountUpdateSuccess {
      ...PersonalAccountUpdateSuccessFragment
    }
  }
}
Variables
{"input": PersonalAccountUpdateInput}
Response
{"data": {"personalAccountUpdate": NameSizeCheckError}}

publish

Description

Publish a new subgraph.

Response

Returns a PublishPayload!

Arguments
Name Description
input - PublishInput!

Example

Query
mutation publish($input: PublishInput!) {
  publish(input: $input) {
    ... on FederatedGraphCompositionError {
      ...FederatedGraphCompositionErrorFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on PublishDeploymentFailure {
      ...PublishDeploymentFailureFragment
    }
    ... on PublishForbidden {
      ...PublishForbiddenFragment
    }
    ... on PublishNoChange {
      ...PublishNoChangeFragment
    }
    ... on PublishSuccess {
      ...PublishSuccessFragment
    }
    ... on SchemaRegistryBranchDoesNotExistError {
      ...SchemaRegistryBranchDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": PublishInput}
Response
{"data": {"publish": FederatedGraphCompositionError}}

schemaCheckCreate

Description

Run checks against the given schema

Response

Returns a SchemaCheckPayload!

Arguments
Name Description
input - SchemaCheckCreateInput!

Example

Query
mutation schemaCheckCreate($input: SchemaCheckCreateInput!) {
  schemaCheckCreate(input: $input) {
    ... on GraphBranchDoesNotExistError {
      ...GraphBranchDoesNotExistErrorFragment
    }
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on SchemaCheck {
      ...SchemaCheckFragment
    }
    ... on SubgraphNameMissingOnFederatedGraphError {
      ...SubgraphNameMissingOnFederatedGraphErrorFragment
    }
  }
}
Variables
{"input": SchemaCheckCreateInput}
Response
{
  "data": {
    "schemaCheckCreate": GraphBranchDoesNotExistError
  }
}

schemaCheckCustomWebhookCreate

Description

Create a SchemaCheckCustomWebhook for a specific graph. Must be issued while logged in as a user.

Arguments
Name Description
input - SchemaCheckCustomWebhookCreateInput!

Example

Query
mutation schemaCheckCustomWebhookCreate($input: SchemaCheckCustomWebhookCreateInput!) {
  schemaCheckCustomWebhookCreate(input: $input) {
    ... on SchemaCheckCustomWebhookCreateSuccess {
      ...SchemaCheckCustomWebhookCreateSuccessFragment
    }
  }
}
Variables
{"input": SchemaCheckCustomWebhookCreateInput}
Response
{
  "data": {
    "schemaCheckCustomWebhookCreate": SchemaCheckCustomWebhookCreateSuccess
  }
}

schemaCheckCustomWebhookDelete

Description

Delete a [CustomCheckWebhook] by id.

Arguments
Name Description
id - ID!

Example

Query
mutation schemaCheckCustomWebhookDelete($id: ID!) {
  schemaCheckCustomWebhookDelete(id: $id) {
    ... on CustomCheckWebhookNotFoundError {
      ...CustomCheckWebhookNotFoundErrorFragment
    }
    ... on SchemaCheckCustomWebhookDeleteSuccess {
      ...SchemaCheckCustomWebhookDeleteSuccessFragment
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "schemaCheckCustomWebhookDelete": CustomCheckWebhookNotFoundError
  }
}

schemaCheckCustomWebhookUpdate

Description

Update a [CustomCheckWebhook] by id.

Arguments
Name Description
input - SchemaCheckCustomWebhookUpdateInput!

Example

Query
mutation schemaCheckCustomWebhookUpdate($input: SchemaCheckCustomWebhookUpdateInput!) {
  schemaCheckCustomWebhookUpdate(input: $input) {
    ... on SchemaCheckCustomWebhookUpdateSuccess {
      ...SchemaCheckCustomWebhookUpdateSuccessFragment
    }
  }
}
Variables
{"input": SchemaCheckCustomWebhookUpdateInput}
Response
{
  "data": {
    "schemaCheckCustomWebhookUpdate": SchemaCheckCustomWebhookUpdateSuccess
  }
}

schemaProposalApprove

Response

Returns a SchemaProposalApprovePayload!

Arguments
Name Description
input - SchemaProposalApproveInput!

Example

Query
mutation schemaProposalApprove($input: SchemaProposalApproveInput!) {
  schemaProposalApprove(input: $input) {
    ... on SchemaProposalApproveSuccess {
      ...SchemaProposalApproveSuccessFragment
    }
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": SchemaProposalApproveInput}
Response
{
  "data": {
    "schemaProposalApprove": SchemaProposalApproveSuccess
  }
}

schemaProposalCommentReply

Arguments
Name Description
parentCommentId - ID!
text - String!

Example

Query
mutation schemaProposalCommentReply(
  $parentCommentId: ID!,
  $text: String!
) {
  schemaProposalCommentReply(
    parentCommentId: $parentCommentId,
    text: $text
  ) {
    ... on SchemaProposalCommentReplySuccess {
      ...SchemaProposalCommentReplySuccessFragment
    }
  }
}
Variables
{
  "parentCommentId": "4",
  "text": "xyz789"
}
Response
{
  "data": {
    "schemaProposalCommentReply": SchemaProposalCommentReplySuccess
  }
}

schemaProposalCommentThreadCreate

Arguments
Name Description
input - SchemaProposalCommentThreadCreateInput!

Example

Query
mutation schemaProposalCommentThreadCreate($input: SchemaProposalCommentThreadCreateInput!) {
  schemaProposalCommentThreadCreate(input: $input) {
    ... on SchemaProposalCommentThreadCreateSuccess {
      ...SchemaProposalCommentThreadCreateSuccessFragment
    }
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
  }
}
Variables
{"input": SchemaProposalCommentThreadCreateInput}
Response
{
  "data": {
    "schemaProposalCommentThreadCreate": SchemaProposalCommentThreadCreateSuccess
  }
}

schemaProposalCommentThreadResolve

Description

Mark a comment thread as resolved.

Arguments
Name Description
rootCommentId - ID!

Example

Query
mutation schemaProposalCommentThreadResolve($rootCommentId: ID!) {
  schemaProposalCommentThreadResolve(rootCommentId: $rootCommentId) {
    ... on SchemaProposalCommentThreadResolveSuccess {
      ...SchemaProposalCommentThreadResolveSuccessFragment
    }
  }
}
Variables
{"rootCommentId": "4"}
Response
{
  "data": {
    "schemaProposalCommentThreadResolve": SchemaProposalCommentThreadResolveSuccess
  }
}

schemaProposalCommentThreadUnresolve

Description

Reverts the resolution of a comment thread.

Arguments
Name Description
rootCommentId - ID!

Example

Query
mutation schemaProposalCommentThreadUnresolve($rootCommentId: ID!) {
  schemaProposalCommentThreadUnresolve(rootCommentId: $rootCommentId) {
    ... on SchemaProposalCommentThreadUnresolveSuccess {
      ...SchemaProposalCommentThreadUnresolveSuccessFragment
    }
  }
}
Variables
{"rootCommentId": 4}
Response
{
  "data": {
    "schemaProposalCommentThreadUnresolve": SchemaProposalCommentThreadUnresolveSuccess
  }
}

schemaProposalCreate

Response

Returns a SchemaProposalCreatePayload!

Arguments
Name Description
input - SchemaProposalCreateInput!

Example

Query
mutation schemaProposalCreate($input: SchemaProposalCreateInput!) {
  schemaProposalCreate(input: $input) {
    ... on SchemaProposalCreateSuccess {
      ...SchemaProposalCreateSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalCreateInput}
Response
{
  "data": {
    "schemaProposalCreate": SchemaProposalCreateSuccess
  }
}

schemaProposalDelete

Response

Returns a SchemaProposalDeletePayload!

Arguments
Name Description
id - ID!

Example

Query
mutation schemaProposalDelete($id: ID!) {
  schemaProposalDelete(id: $id) {
    ... on SchemaProposalDeleteSuccess {
      ...SchemaProposalDeleteSuccessFragment
    }
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
  }
}
Variables
{"id": "4"}
Response
{
  "data": {
    "schemaProposalDelete": SchemaProposalDeleteSuccess
  }
}

schemaProposalEdit

Description

Edit the contents of a proposal.

The proposed subgraphs can be just a subset of the subgraphs being edited in the proposal. The changes from the previous edit on other subgraphs be carried over.

Response

Returns a SchemaProposalEditPayload!

Arguments
Name Description
input - SchemaProposalEditInput!

Example

Query
mutation schemaProposalEdit($input: SchemaProposalEditInput!) {
  schemaProposalEdit(input: $input) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalEditParserErrors {
      ...SchemaProposalEditParserErrorsFragment
    }
    ... on SchemaProposalEditSuccess {
      ...SchemaProposalEditSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalEditInput}
Response
{
  "data": {
    "schemaProposalEdit": SchemaProposalDoesNotExistError
  }
}

schemaProposalReject

Response

Returns a SchemaProposalRejectPayload!

Arguments
Name Description
input - SchemaProposalRejectInput!

Example

Query
mutation schemaProposalReject($input: SchemaProposalRejectInput!) {
  schemaProposalReject(input: $input) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalRejectSuccess {
      ...SchemaProposalRejectSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalRejectInput}
Response
{
  "data": {
    "schemaProposalReject": SchemaProposalDoesNotExistError
  }
}

schemaProposalRequestReview

Arguments
Name Description
input - SchemaProposalRequestReviewInput!

Example

Query
mutation schemaProposalRequestReview($input: SchemaProposalRequestReviewInput!) {
  schemaProposalRequestReview(input: $input) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalRequestReviewSuccess {
      ...SchemaProposalRequestReviewSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalRequestReviewInput}
Response
{
  "data": {
    "schemaProposalRequestReview": SchemaProposalDoesNotExistError
  }
}

schemaProposalRevertToDraft

Description

Take a schema proposal back to draft status. This is possible from any state.

Arguments
Name Description
schemaProposalId - ID!

Example

Query
mutation schemaProposalRevertToDraft($schemaProposalId: ID!) {
  schemaProposalRevertToDraft(schemaProposalId: $schemaProposalId) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalRevertToDraftSuccess {
      ...SchemaProposalRevertToDraftSuccessFragment
    }
  }
}
Variables
{"schemaProposalId": "4"}
Response
{
  "data": {
    "schemaProposalRevertToDraft": SchemaProposalDoesNotExistError
  }
}

schemaProposalReviewRequestCreate

Description

Request a review for a schema proposal from a user or a team.

Arguments
Name Description
input - SchemaProposalReviewRequestCreateInput!

Example

Query
mutation schemaProposalReviewRequestCreate($input: SchemaProposalReviewRequestCreateInput!) {
  schemaProposalReviewRequestCreate(input: $input) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalReviewRequestCreateSuccess {
      ...SchemaProposalReviewRequestCreateSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalReviewRequestCreateInput}
Response
{
  "data": {
    "schemaProposalReviewRequestCreate": SchemaProposalDoesNotExistError
  }
}

schemaProposalUpdate

Description

Update schema proposal metadata (title and description).

Response

Returns a SchemaProposalUpdatePayload!

Arguments
Name Description
input - SchemaProposalUpdateInput!

Example

Query
mutation schemaProposalUpdate($input: SchemaProposalUpdateInput!) {
  schemaProposalUpdate(input: $input) {
    ... on SchemaProposalDoesNotExistError {
      ...SchemaProposalDoesNotExistErrorFragment
    }
    ... on SchemaProposalUpdateSuccess {
      ...SchemaProposalUpdateSuccessFragment
    }
  }
}
Variables
{"input": SchemaProposalUpdateInput}
Response
{
  "data": {
    "schemaProposalUpdate": SchemaProposalDoesNotExistError
  }
}

slackIntegrationCreate

Response

Returns a SlackNotificationCreatePayload!

Arguments
Name Description
input - SlackIntegrationCreateInput!

Example

Query
mutation slackIntegrationCreate($input: SlackIntegrationCreateInput!) {
  slackIntegrationCreate(input: $input) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on SlackNotification {
      ...SlackNotificationFragment
    }
  }
}
Variables
{"input": SlackIntegrationCreateInput}
Response
{
  "data": {
    "slackIntegrationCreate": GraphDoesNotExistError
  }
}

slackNotificationDelete

Response

Returns a SlackNotificationDeletePayload!

Arguments
Name Description
id - String!

Example

Query
mutation slackNotificationDelete($id: String!) {
  slackNotificationDelete(id: $id) {
    ... on Query {
      ...QueryFragment
    }
  }
}
Variables
{"id": "xyz789"}
Response
{"data": {"slackNotificationDelete": Query}}

subgraphAddOwner

Description

Assign a team as the owner of a subgraph

Response

Returns a SubgraphAddOwnerPayload!

Arguments
Name Description
branchId - ID!
subgraphName - String!
owner - ID!

Example

Query
mutation subgraphAddOwner(
  $branchId: ID!,
  $subgraphName: String!,
  $owner: ID!
) {
  subgraphAddOwner(
    branchId: $branchId,
    subgraphName: $subgraphName,
    owner: $owner
  ) {
    ... on SubgraphAddOwnerSuccess {
      ...SubgraphAddOwnerSuccessFragment
    }
  }
}
Variables
{
  "branchId": 4,
  "subgraphName": "xyz789",
  "owner": 4
}
Response
{"data": {"subgraphAddOwner": SubgraphAddOwnerSuccess}}

subgraphRemoveOwner

Description

Unassign a team's ownership of a subgraph

Response

Returns a SubgraphRemoveOwnerPayload!

Arguments
Name Description
branchId - ID!
subgraphName - String!

Example

Query
mutation subgraphRemoveOwner(
  $branchId: ID!,
  $subgraphName: String!
) {
  subgraphRemoveOwner(
    branchId: $branchId,
    subgraphName: $subgraphName
  ) {
    ... on SubgraphRemoveOwnerSuccess {
      ...SubgraphRemoveOwnerSuccessFragment
    }
  }
}
Variables
{"branchId": 4, "subgraphName": "abc123"}
Response
{
  "data": {
    "subgraphRemoveOwner": SubgraphRemoveOwnerSuccess
  }
}

teamAddMember

Response

Returns a TeamAddMemberPayload!

Arguments
Name Description
teamId - ID!
memberId - ID!

Example

Query
mutation teamAddMember(
  $teamId: ID!,
  $memberId: ID!
) {
  teamAddMember(
    teamId: $teamId,
    memberId: $memberId
  ) {
    ... on TeamAddMemberSuccess {
      ...TeamAddMemberSuccessFragment
    }
    ... on TeamDoesNotExistError {
      ...TeamDoesNotExistErrorFragment
    }
  }
}
Variables
{"teamId": "4", "memberId": 4}
Response
{"data": {"teamAddMember": TeamAddMemberSuccess}}

teamAssignRole

Response

Returns a TeamAssignRolePayload!

Arguments
Name Description
role - TeamRole!
teamId - ID!
memberId - ID!

Example

Query
mutation teamAssignRole(
  $role: TeamRole!,
  $teamId: ID!,
  $memberId: ID!
) {
  teamAssignRole(
    role: $role,
    teamId: $teamId,
    memberId: $memberId
  ) {
    ... on TeamAssignRoleSuccess {
      ...TeamAssignRoleSuccessFragment
    }
    ... on TeamDoesNotExistError {
      ...TeamDoesNotExistErrorFragment
    }
  }
}
Variables
{
  "role": "MEMBER",
  "teamId": 4,
  "memberId": "4"
}
Response
{"data": {"teamAssignRole": TeamAssignRoleSuccess}}

teamCreate

Response

Returns a TeamCreatePayload!

Arguments
Name Description
name - String!
organizationId - ID!

Example

Query
mutation teamCreate(
  $name: String!,
  $organizationId: ID!
) {
  teamCreate(
    name: $name,
    organizationId: $organizationId
  ) {
    ... on OrganizationDoesNotExistError {
      ...OrganizationDoesNotExistErrorFragment
    }
    ... on Team {
      ...TeamFragment
    }
    ... on TeamNameAlreadyTakenError {
      ...TeamNameAlreadyTakenErrorFragment
    }
  }
}
Variables
{"name": "xyz789", "organizationId": 4}
Response
{"data": {"teamCreate": OrganizationDoesNotExistError}}

teamDelete

Response

Returns a TeamDeletePayload!

Arguments
Name Description
teamId - ID!

Example

Query
mutation teamDelete($teamId: ID!) {
  teamDelete(teamId: $teamId) {
    ... on TeamDeleteSuccess {
      ...TeamDeleteSuccessFragment
    }
    ... on TeamDoesNotExistError {
      ...TeamDoesNotExistErrorFragment
    }
  }
}
Variables
{"teamId": 4}
Response
{"data": {"teamDelete": TeamDeleteSuccess}}

teamRemoveMember

Response

Returns a TeamRemoveMemberPayload!

Arguments
Name Description
teamId - ID!
memberId - ID!

Example

Query
mutation teamRemoveMember(
  $teamId: ID!,
  $memberId: ID!
) {
  teamRemoveMember(
    teamId: $teamId,
    memberId: $memberId
  ) {
    ... on TeamDoesNotExistError {
      ...TeamDoesNotExistErrorFragment
    }
    ... on TeamRemoveMemberSuccess {
      ...TeamRemoveMemberSuccessFragment
    }
  }
}
Variables
{"teamId": "4", "memberId": 4}
Response
{"data": {"teamRemoveMember": TeamDoesNotExistError}}

trustedDocumentsSubmit

Response

Returns a TrustedDocumentsSubmitPayload!

Arguments
Name Description
accountSlug - String
graphSlug - String
branchSlug - String!
clientName - String!
documents - [TrustedDocumentInput!]!

Example

Query
mutation trustedDocumentsSubmit(
  $accountSlug: String,
  $graphSlug: String,
  $branchSlug: String!,
  $clientName: String!,
  $documents: [TrustedDocumentInput!]!
) {
  trustedDocumentsSubmit(
    accountSlug: $accountSlug,
    graphSlug: $graphSlug,
    branchSlug: $branchSlug,
    clientName: $clientName,
    documents: $documents
  ) {
    ... on GraphDoesNotExistError {
      ...GraphDoesNotExistErrorFragment
    }
    ... on OldAccessTokenError {
      ...OldAccessTokenErrorFragment
    }
    ... on ReusedIds {
      ...ReusedIdsFragment
    }
    ... on TrustedDocumentsSubmitSuccess {
      ...TrustedDocumentsSubmitSuccessFragment
    }
  }
}
Variables
{
  "accountSlug": "xyz789",
  "graphSlug": "abc123",
  "branchSlug": "xyz789",
  "clientName": "xyz789",
  "documents": [TrustedDocumentInput]
}
Response
{
  "data": {
    "trustedDocumentsSubmit": GraphDoesNotExistError
  }
}

userDelete

Description

Delete the user.

Response

Returns a UserDeletePayload!

Example

Query
mutation userDelete {
  userDelete {
    ... on OrganizationOwnershipNotTransferredError {
      ...OrganizationOwnershipNotTransferredErrorFragment
    }
    ... on UserDeleteSuccess {
      ...UserDeleteSuccessFragment
    }
  }
}
Response
{
  "data": {
    "userDelete": OrganizationOwnershipNotTransferredError
  }
}

userUpdate

Response

Returns a UserUpdatePayload!

Arguments
Name Description
input - UserUpdateInput!

Example

Query
mutation userUpdate($input: UserUpdateInput!) {
  userUpdate(input: $input) {
    ... on NameSizeCheckError {
      ...NameSizeCheckErrorFragment
    }
    ... on UserUpdateSuccess {
      ...UserUpdateSuccessFragment
    }
  }
}
Variables
{"input": UserUpdateInput}
Response
{"data": {"userUpdate": NameSizeCheckError}}

zitadelAddRedirect

Response

Returns a ZitadelAddRedirectPayload

Example

Query
mutation zitadelAddRedirect {
  zitadelAddRedirect {
    ... on NotEnterprisePlatformError {
      ...NotEnterprisePlatformErrorFragment
    }
    ... on ZitadelAddRedirectFailure {
      ...ZitadelAddRedirectFailureFragment
    }
    ... on ZitadelAddRedirectSuccess {
      ...ZitadelAddRedirectSuccessFragment
    }
  }
}
Response
{
  "data": {
    "zitadelAddRedirect": NotEnterprisePlatformError
  }
}

zitadelInit

Response

Returns a ZitadelInitPayload

Example

Query
mutation zitadelInit {
  zitadelInit {
    ... on NotEnterprisePlatformError {
      ...NotEnterprisePlatformErrorFragment
    }
    ... on ZitadelInitFailure {
      ...ZitadelInitFailureFragment
    }
    ... on ZitadelInitSuccess {
      ...ZitadelInitSuccessFragment
    }
  }
}
Response
{"data": {"zitadelInit": NotEnterprisePlatformError}}

Subscriptions

notificationsInboxMessages

Description

Whenever new notifications are available for the current user, return how many.

Response

Returns an Int!

Example

Query
subscription notificationsInboxMessages {
  notificationsInboxMessages
}
Response
{"data": {"notificationsInboxMessages": 987}}

Types

AccessToken

Fields
Field Name Description
accountId - ID
createdAt - DateTime!
expiresAt - DateTime
graphScopes - [Graph!]!
id - ID!
name - String!
Example
{
  "accountId": "4",
  "createdAt": "2007-12-03T10:15:30Z",
  "expiresAt": "2007-12-03T10:15:30Z",
  "graphScopes": [Graph],
  "id": "4",
  "name": "abc123"
}

AccessTokenConnection

Fields
Field Name Description
edges - [AccessTokenEdge!]! A list of edges.
nodes - [AccessToken!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [AccessTokenEdge],
  "nodes": [AccessToken],
  "pageInfo": PageInfo
}

AccessTokenCreateInput

Fields
Input Field Description
name - String!
accountId - ID
graphScopes - [ID!]
expiresAt - DateTime
kind - AccessTokenKind!
Example
{
  "name": "xyz789",
  "accountId": 4,
  "graphScopes": [4],
  "expiresAt": "2007-12-03T10:15:30Z",
  "kind": "USER"
}

AccessTokenCreatePayload

AccessTokenCreateSuccess

Fields
Field Name Description
jwt - String!
query - Query!
token - AccessToken!
Example
{
  "jwt": "abc123",
  "query": Query,
  "token": AccessToken
}

AccessTokenDeleteInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

AccessTokenDeletePayload

Example
AccessTokenDeleteSuccess

AccessTokenDeleteSuccess

Fields
Field Name Description
deletedId - ID!
query - Query!
Example
{"deletedId": 4, "query": Query}

AccessTokenEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - AccessToken! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": AccessToken
}

AccessTokenKind

Values
Enum Value Description

USER

ACCOUNT

Example
"USER"

Account

Fields
Field Name Description
accessTokens - AccessTokenConnection!
Arguments
after - String
before - String
first - Int
last - Int
createdAt - DateTime!
graphs - GraphConnection!
Arguments
after - String
before - String
first - Int
last - Int
id - ID!
name - String!
plan - GrafbasePlan!
slug - String!
status - AccountStatus!
usage - AccountUsageTimeSeries
Arguments
filters - UsageFilters!
Possible Types
Account Types

Organization

Example
{
  "accessTokens": AccessTokenConnection,
  "createdAt": "2007-12-03T10:15:30Z",
  "graphs": GraphConnection,
  "id": 4,
  "name": "abc123",
  "plan": "TRIAL",
  "slug": "abc123",
  "status": AccountStatus,
  "usage": AccountUsageTimeSeries
}

AccountCreationValidateInput

Fields
Input Field Description
slug - String!
Example
{"slug": "xyz789"}

AccountCreationValidatePayload

Fields
Field Name Description
slugAvailable - Boolean!
Example
{"slugAvailable": true}

AccountDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

AccountIdMissingForAccountAccessTokenError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

AccountStatus

Fields
Field Name Description
isEnabled - Boolean!
Example
{"isEnabled": true}

AccountUsageTimeSeries

Fields
Field Name Description
overall - UsageMetrics!
points - [UsageMetricsTimeSeriesDataPoint!]!
Example
{
  "overall": UsageMetrics,
  "points": [UsageMetricsTimeSeriesDataPoint]
}

AlreadyExistsError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

AlreadyMemberError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

BadWasmModuleError

Fields
Field Name Description
error - String!
query - Query!
Example
{
  "error": "xyz789",
  "query": Query
}

Boolean

Example
true

Branch

Fields
Field Name Description
activeDeployment - Deployment
analytics - GraphAnalytics
Arguments
deployments - DeploymentConnection!
Arguments
after - String
before - String
first - Int
last - Int
filters - DeploymentFilters
domains - [String!]!
endpointConfig - EndpointConfig
environment - BranchEnvironment!
federatedSchema - String
graph - Graph!
id - ID!
latestDeployment - Deployment
name - String!
operationChecksEnabled - Boolean!
operationChecksIgnoreUsageData - Boolean! Whether usage data should be ignored when running operation checks.
schema - String
schemaProposals - SchemaProposalConnection!
Arguments
after - String
first - Int
schemaProposalsConfiguration - SchemaProposalsConfiguration!
subgraphs - [Subgraph!]!
Example
{
  "activeDeployment": Deployment,
  "analytics": GraphAnalytics,
  "deployments": DeploymentConnection,
  "domains": ["xyz789"],
  "endpointConfig": EndpointConfig,
  "environment": "PREVIEW",
  "federatedSchema": "xyz789",
  "graph": Graph,
  "id": "4",
  "latestDeployment": Deployment,
  "name": "xyz789",
  "operationChecksEnabled": true,
  "operationChecksIgnoreUsageData": false,
  "schema": "abc123",
  "schemaProposals": SchemaProposalConnection,
  "schemaProposalsConfiguration": SchemaProposalsConfiguration,
  "subgraphs": [Subgraph]
}

BranchAlreadyExistsError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

BranchConnection

Fields
Field Name Description
edges - [BranchEdge!]! A list of edges.
nodes - [Branch!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [BranchEdge],
  "nodes": [Branch],
  "pageInfo": PageInfo
}

BranchCreateInput

Fields
Input Field Description
accountSlug - String!
graphSlug - String!
branchName - String!
Example
{
  "accountSlug": "xyz789",
  "graphSlug": "abc123",
  "branchName": "abc123"
}

BranchCreatePayload

Example
BranchAlreadyExistsError

BranchDeletePayload

Example
BranchDoesNotExistError

BranchDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

BranchEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Branch! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Branch
}

BranchEnvironment

Values
Enum Value Description

PREVIEW

PRODUCTION

Example
"PREVIEW"

BranchUpdateInput

Fields
Input Field Description
operationChecksEnabled - Boolean Toggle whether operation checks are run along with other schema checks.
operationChecksIgnoreUsageData - Boolean When this is enabled, operation checks will not take usage data into account. Any change that is theoretically breaking (like making a required output field optional) will be considered breaking.
schemaProposalsConfiguration - SchemaProposalsConfigurationUpdateInput
accountSlug - String!
graphSlug - String
branchSlug - String!
trustedDocumentsEnforce - Boolean
trustedDocumentsBypassHeaderName - String
trustedDocumentsBypassHeaderValue - String
Example
{
  "operationChecksEnabled": true,
  "operationChecksIgnoreUsageData": false,
  "schemaProposalsConfiguration": SchemaProposalsConfigurationUpdateInput,
  "accountSlug": "abc123",
  "graphSlug": "xyz789",
  "branchSlug": "xyz789",
  "trustedDocumentsEnforce": false,
  "trustedDocumentsBypassHeaderName": "abc123",
  "trustedDocumentsBypassHeaderValue": "xyz789"
}

BranchUpdatePayload

Types
Union Types

GraphDoesNotExistError

Query

Example
GraphDoesNotExistError

CannotBeRenamedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

CannotDeleteProductionBranchError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

CannotUseInvitationsWithSso

Fields
Field Name Description
query - Query!
Example
{"query": Query}

CompositionCheckError

Fields
Field Name Description
message - String!
severity - SchemaCheckErrorSeverity!
title - String!
Example
{
  "message": "xyz789",
  "severity": "ERROR",
  "title": "abc123"
}

CouldNotFindGraphsError

Fields
Field Name Description
unknownGraphIds - [ID!]!
Example
{"unknownGraphIds": ["4"]}

CurrentPlanLimitReachedError

Fields
Field Name Description
max - Int!
query - Query!
Example
{"max": 123, "query": Query}

CustomCheckWebhook

Fields
Field Name Description
createdAt - DateTime!
createdBy - User
headers - [HttpHeader!]! The headers sent to the webhook with custom check events.
id - ID!
url - Url! The url called as part of custom checks.
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "createdBy": User,
  "headers": [HttpHeader],
  "id": 4,
  "url": Url
}

CustomCheckWebhookNotFoundError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

DateTime

Description

RFC3339 formatted date in the UTC time zone denoted by letter 'Z'

Example
"2007-12-03T10:15:30Z"

DeleteSubgraphDeploymentFailure

Fields
Field Name Description
deploymentError - String!
query - Query!
Example
{
  "deploymentError": "abc123",
  "query": Query
}

DeleteSubgraphInput

Fields
Input Field Description
accountSlug - String!
graphSlug - String
message - String
branch - String!
subgraph - String!
dryRun - Boolean!
Example
{
  "accountSlug": "xyz789",
  "graphSlug": "abc123",
  "message": "abc123",
  "branch": "abc123",
  "subgraph": "abc123",
  "dryRun": false
}

DeleteSubgraphPayload

DeleteSubgraphSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Deployment

Description

Deployment

Fields
Field Name Description
apiSchema - String The schema exposed by the gateway.
apiSchemaDiff - [DiffSnippet!] Diff of the API SDL in this deployment with the last successful deployment. This field only makes sense for successful deployments, so it will be null on failed deployments.
branch - Branch!
changeCounts - DeploymentChangeCounts
compositionInputs - [DeploymentSubgraph!]!
createdAt - DateTime!
duration - Int The duration of the deployment in milliseconds.
federatedSdl - String The federated SDL used to initialize the gateway.
finishedAt - DateTime
id - ID!
isRedeployable - Boolean!
message - String
schemaVersion - SchemaVersion
startedAt - DateTime
status - DeploymentStatus!
steps - [DeploymentStep!]!
subgraph - DeploymentSubgraph

The subgraph that was published or removed, triggering the deployment.

This is nullable in case we introduce back redeployments in the future.

Example
{
  "apiSchema": "xyz789",
  "apiSchemaDiff": [DiffSnippet],
  "branch": Branch,
  "changeCounts": DeploymentChangeCounts,
  "compositionInputs": [DeploymentSubgraph],
  "createdAt": "2007-12-03T10:15:30Z",
  "duration": 123,
  "federatedSdl": "xyz789",
  "finishedAt": "2007-12-03T10:15:30Z",
  "id": "4",
  "isRedeployable": false,
  "message": "abc123",
  "schemaVersion": SchemaVersion,
  "startedAt": "2007-12-03T10:15:30Z",
  "status": "QUEUED",
  "steps": [DeploymentStep],
  "subgraph": DeploymentSubgraph
}

DeploymentChangeCounts

Fields
Field Name Description
addedFields - Int!
addedTypes - Int!
changedFields - Int!
changedTypes - Int!
removedFields - Int!
removedTypes - Int!
Example
{
  "addedFields": 987,
  "addedTypes": 987,
  "changedFields": 987,
  "changedTypes": 123,
  "removedFields": 987,
  "removedTypes": 123
}

DeploymentConnection

Fields
Field Name Description
edges - [DeploymentEdge!]! A list of edges.
nodes - [Deployment!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [DeploymentEdge],
  "nodes": [Deployment],
  "pageInfo": PageInfo
}

DeploymentEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Deployment! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Deployment
}

DeploymentFilters

Fields
Input Field Description
finishedAt - DeploymentFinishedAtFilters
Example
{"finishedAt": DeploymentFinishedAtFilters}

DeploymentFinishedAtFilters

Fields
Input Field Description
range - Duration Use this if you really care about having a specific duration like 1 hour, 7 days, etc.
from - DateTime Use this if you at least the data between from and to to be provided. You may get more, but never less.
to - DateTime! To be used in conjunction with with either range or from.
Example
{
  "range": "P3Y6M4DT12H30M5S",
  "from": "2007-12-03T10:15:30Z",
  "to": "2007-12-03T10:15:30Z"
}

DeploymentStatus

Values
Enum Value Description

QUEUED

IN_PROGRESS

SUCCEEDED

FAILED

Example
"QUEUED"

DeploymentStep

Fields
Field Name Description
durationMs - Int!
errors - [DeploymentStepError!]!
startedAt - DateTime!
status - DeploymentStepStatus!
title - String!
Example
{
  "durationMs": 123,
  "errors": [DeploymentStepGeneralError],
  "startedAt": "2007-12-03T10:15:30Z",
  "status": "SUCCESS",
  "title": "abc123"
}

DeploymentStepError

Types
Union Types

DeploymentStepGeneralError

Example
DeploymentStepGeneralError

DeploymentStepGeneralError

Fields
Field Name Description
message - String!
Example
{"message": "abc123"}

DeploymentStepStatus

Values
Enum Value Description

SUCCESS

FAILURE

Example
"SUCCESS"

DeploymentSubgraph

Fields
Field Name Description
name - String!
url - String
versionNumber - Int!
Example
{
  "name": "xyz789",
  "url": "xyz789",
  "versionNumber": 123
}

DiffSide

Description

One side of a two-sided diff. "Old" and "new" are to be taken in the most general sense.

Values
Enum Value Description

OLD

NEW

Example
"OLD"

DiffSnippet

Fields
Field Name Description
addedLines - [Int!]!
originalSchemaSnippet - String!
originalSchemaSnippetFirstLine - Int!
proposedSchemaSnippet - String!
proposedSchemaSnippetFirstLine - Int!
removedLines - [Int!]!
Example
{
  "addedLines": [987],
  "originalSchemaSnippet": "abc123",
  "originalSchemaSnippetFirstLine": 123,
  "proposedSchemaSnippet": "xyz789",
  "proposedSchemaSnippetFirstLine": 987,
  "removedLines": [123]
}

DisabledAccountError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Duration

Description

Implement the Duration scalar

The input/output is a string in ISO8601 format.

Example
"P3Y6M4DT12H30M5S"

DurationFilter

Fields
Input Field Description
lt - Duration
lte - Duration
gt - Duration
gte - Duration
Example
{
  "lt": "P3Y6M4DT12H30M5S",
  "lte": "P3Y6M4DT12H30M5S",
  "gt": "P3Y6M4DT12H30M5S",
  "gte": "P3Y6M4DT12H30M5S"
}

EndpointConfig

Fields
Field Name Description
url - String!
Example
{"url": "abc123"}

EndpointConfigInput

Fields
Input Field Description
url - String!
Example
{"url": "abc123"}

EndpointConfigUpdateInput

Fields
Input Field Description
endpointConfig - EndpointConfigInput!
accountSlug - String!
graphSlug - String!
branchSlug - String!
Example
{
  "endpointConfig": EndpointConfigInput,
  "accountSlug": "xyz789",
  "graphSlug": "abc123",
  "branchSlug": "abc123"
}

EndpointConfigUpdatePayload

Types
Union Types

GraphDoesNotExistError

Query

Example
GraphDoesNotExistError

ErrorCountByCode

Fields
Field Name Description
code - String!
count - Int!
Example
{"code": "xyz789", "count": 123}

Extension

Fields
Field Name Description
highestVersion - ExtensionVersion
id - ID!
name - String!
owners - [User!]
versions - [ExtensionVersion!]!
Example
{
  "highestVersion": ExtensionVersion,
  "id": 4,
  "name": "abc123",
  "owners": [User],
  "versions": [ExtensionVersion]
}

ExtensionAddOwnerPayload

Example
ExtensionAddOwnerSuccess

ExtensionAddOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ExtensionConnection

Fields
Field Name Description
edges - [ExtensionEdge!]! A list of edges.
nodes - [Extension!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [ExtensionEdge],
  "nodes": [Extension],
  "pageInfo": PageInfo
}

ExtensionDefaultPermission

Values
Enum Value Description

NETWORK

STDOUT

STDERR

ENVIRONMENT_VARIABLES

Example
"NETWORK"

ExtensionDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ExtensionEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Extension! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": Extension
}

ExtensionFilter

Fields
Input Field Description
namePrefix - String
Example
{"namePrefix": "xyz789"}

ExtensionKind

Values
Enum Value Description

FIELD_RESOLVER

AUTHENTICATOR

Replaced by AUTHENTICATION

AUTHENTICATION

AUTHORIZATION

SELECTION_SET_RESOLVER

RESOLVER

HOOKS

CONTRACTS

Example
"FIELD_RESOLVER"

ExtensionPublishPayload

ExtensionPublishSuccess

Fields
Field Name Description
extensionVersion - ExtensionVersion!
query - Query!
Example
{
  "extensionVersion": ExtensionVersion,
  "query": Query
}

ExtensionRemoveOwnerPayload

Example
ExtensionDoesNotExistError

ExtensionRemoveOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ExtensionUnauthorized

Fields
Field Name Description
message - String!
query - Query!
Example
{
  "message": "xyz789",
  "query": Query
}

ExtensionValidationError

Fields
Field Name Description
error - String!
query - Query!
Example
{
  "error": "abc123",
  "query": Query
}

ExtensionVersion

Fields
Field Name Description
createdAt - DateTime!
defaultPermissions - [ExtensionDefaultPermission!]
definitionsSdl - String
description - String!
extension - Extension!
homepageUrl - Url
kind - ExtensionKind!
license - String
minimumCompatibleGatewayVersion - SemverVersion
publishedBy - User
readme - String
repositoryUrl - Url
sdkVersion - SemverVersion!
sdl - String
version - SemverVersion!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "defaultPermissions": ["NETWORK"],
  "definitionsSdl": "abc123",
  "description": "xyz789",
  "extension": Extension,
  "homepageUrl": Url,
  "kind": "FIELD_RESOLVER",
  "license": "abc123",
  "minimumCompatibleGatewayVersion": SemverVersion,
  "publishedBy": User,
  "readme": "abc123",
  "repositoryUrl": Url,
  "sdkVersion": SemverVersion,
  "sdl": "xyz789",
  "version": SemverVersion
}

ExtensionVersionAlreadyExistsError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ExtensionVersionDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ExtensionVersionMatch

Example
ExtensionDoesNotExistError

ExtensionVersionRequirement

Fields
Input Field Description
version - SemverVersionRequirement!
extensionName - String!
Example
{
  "version": SemverVersionRequirement,
  "extensionName": "xyz789"
}

FederatedGraphCompositionError

Fields
Field Name Description
messages - [String!]!
query - Query!
Example
{
  "messages": ["xyz789"],
  "query": Query
}

FieldAnalytics

Fields
Field Name Description
metrics - FieldMetricsTimeSeries
topClients - TopClientsForField
Arguments
limit - Int

Detaults to 10, Max 100

searchQuery - String

Search over the client names/versions

Example
{
  "metrics": FieldMetricsTimeSeries,
  "topClients": TopClientsForField
}

FieldMetrics

Fields
Field Name Description
count - Int!
Example
{"count": 987}

FieldMetricsTimeSeries

Fields
Field Name Description
overall - FieldMetrics!
points - [FieldMetricsTimeSeriesDataPoint!]!
previousPeriod - FieldMetricsTimeSeries
Example
{
  "overall": FieldMetrics,
  "points": [FieldMetricsTimeSeriesDataPoint],
  "previousPeriod": FieldMetricsTimeSeries
}

FieldMetricsTimeSeriesDataPoint

Fields
Field Name Description
count - Int!
dateTime - DateTime!
Example
{
  "count": 987,
  "dateTime": "2007-12-03T10:15:30Z"
}

Float

Example
987.65

GrafbasePlan

Values
Enum Value Description

TRIAL

GROWTH

ENTERPRISE

Example
"TRIAL"

Graph

Fields
Field Name Description
account - Account!
analytics - GraphAnalytics
Arguments
branch - Branch
Arguments
name - String
branches - BranchConnection!
Arguments
after - String
before - String
first - Int
last - Int
createdAt - DateTime!
customCheckWebhooks - [CustomCheckWebhook!] Webhooks for custom schema checks.
id - ID!
operationChecksConfiguration - GraphOperationCheckConfiguration!
owners - [Team!]!
productionBranch - Branch!
request - Request
Arguments
branchName - String
approximateTimestamp - DateTime!

The approximate timestamp of the request, within a few minutes of the actual request.

traceId - ID!
requests - RequestConnection
Arguments
after - String
before - String
first - Int
last - Int
filters - RequestFilters!
schemaChecks - SchemaCheckConnection!
Arguments
after - String
before - String
first - Int
last - Int
branch - String
schemaProposals - SchemaProposalConnection!
Arguments
after - String
first - Int
slug - String!
Example
{
  "account": Account,
  "analytics": GraphAnalytics,
  "branch": Branch,
  "branches": BranchConnection,
  "createdAt": "2007-12-03T10:15:30Z",
  "customCheckWebhooks": [CustomCheckWebhook],
  "id": "4",
  "operationChecksConfiguration": GraphOperationCheckConfiguration,
  "owners": [Team],
  "productionBranch": Branch,
  "request": Request,
  "requests": RequestConnection,
  "schemaChecks": SchemaCheckConnection,
  "schemaProposals": SchemaProposalConnection,
  "slug": "abc123"
}

GraphAddOwnerPayload

Example
GraphAddOwnerSuccess

GraphAddOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphAnalytics

Fields
Field Name Description
forField - FieldAnalytics!
Arguments
schemaPath - String!

Schema path defined as: '.'

requestMetrics - RequestMetricsTimeSeriesV2
Arguments
latencyPercentiles - [Float!]

Latency percentiles to retrieve. Ex: [50, 99, 99.9]

topClients - TopClients
Arguments
limit - Int

Detaults to 10, Max 100

searchQuery - String

Search over the client names/versions

latencyPercentile - Float

If not specified, top clients by latency will be empty. Ex: 95

topOperations - TopOperations
Arguments
limit - Int

Detaults to 10, Max 100

searchQuery - String

Search over the opeartion names

latencyPercentile - Float

If not specified, top operations by latency will be empty. Ex: 95

Example
{
  "forField": FieldAnalytics,
  "requestMetrics": RequestMetricsTimeSeriesV2,
  "topClients": TopClients,
  "topOperations": TopOperations
}

GraphAnalyticsFilters

Fields
Input Field Description
branchName - String Defaults to production branch
range - Duration Use this if you really care about having a specific duration like 1 hour, 7 days, etc.
from - DateTime Use this if you at least the data between from and to to be provided. You may get more, but never less.
to - DateTime! To be used in conjunction with with either range or from.
isCustomRange - Boolean If explicitly to false, specifying both from and to will be treated as if range: (to - from) had been specified instead. Meaning only the duration between from and to matters, not necessarily having a data point for from itself.
aggregationStep - Duration If specified, overrides approximateNumberOfPoints. Must be in whole minutes. At most 150 points can be returned.
approximateNumberOfDataPoints - Int Defaults to 100, at most 150 points can be returned.
alignPeriodWithAggregationStep - Boolean

Defaults to true Example: for an aggregationStep of 15 min:

  • if true, only times with 00, 15, 30 and 45 minutes will appear in the time series
  • if false, times in the time series will be adjusted to start from the periodStart (~from). So if from = 15:32:00, times will end in 02, 17, 32 and 47. I'll always align to the aggregation step used to store the data though, which is currently in minutes. So cannot have 15:10:20, 15:11:20, etc.
operationName - [String!]
operationNormalizedQueryHash - [OperationNormalizedQueryHash!] Only used if operation name is specified.
clientName - [String!]
clientVersion - [String!] Only used if client name is specified.
Example
{
  "branchName": "abc123",
  "range": "P3Y6M4DT12H30M5S",
  "from": "2007-12-03T10:15:30Z",
  "to": "2007-12-03T10:15:30Z",
  "isCustomRange": true,
  "aggregationStep": "P3Y6M4DT12H30M5S",
  "approximateNumberOfDataPoints": 987,
  "alignPeriodWithAggregationStep": true,
  "operationName": ["xyz789"],
  "operationNormalizedQueryHash": [
    OperationNormalizedQueryHash
  ],
  "clientName": ["xyz789"],
  "clientVersion": ["xyz789"]
}

GraphBranchDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphConnection

Fields
Field Name Description
edges - [GraphEdge!]! A list of edges.
nodes - [Graph!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [GraphEdge],
  "nodes": [Graph],
  "pageInfo": PageInfo
}

GraphCreateInput

Fields
Input Field Description
accountId - ID!
graphSlug - String!
Example
{"accountId": 4, "graphSlug": "abc123"}

GraphCreatePayload

GraphCreateSuccess

Fields
Field Name Description
graph - Graph!
query - Query!
Example
{"graph": Graph, "query": Query}

GraphDeleteInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

GraphDeletePayload

Example
GraphDeleteSuccess

GraphDeleteSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Graph! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": Graph
}

GraphNotFederatedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphNotSelfHostedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphOperationCheckConfiguration

Fields
Field Name Description
excludedClients - [String!]! The clients to exclude from operation checks.
excludedOperations - [String!]! The operations to exclude from operation checks.
requestCountThreshold - Int! The request count threshold to consider for operation checks. Operations that have been registered less than the specified number of occurrences are ignored.
timeRangeDays - Int! The time range in days to consider for operation checks. Operations older than the specificied number of days are ignored.
Example
{
  "excludedClients": ["xyz789"],
  "excludedOperations": ["abc123"],
  "requestCountThreshold": 123,
  "timeRangeDays": 987
}

GraphOperationCheckConfigurationInput

Fields
Input Field Description
timeRangeDays - Int The time range in days to consider for operation checks. Operations older than the specificied number of days are ignored.
requestCountThreshold - Int The request count threshold to consider for operation checks. Operations that have been registered less than the specified number of occurrences are ignored.
excludedClients - [String!] The clients to exclude from operation checks.
excludedOperations - [String!] The operations to exclude from operation checks.
graphId - ID! The graph to update.
enabled - Boolean Whether operation checks are enabled for the graph. This is ignored, since operation checks are now only enabled at the branch level.
Example
{
  "timeRangeDays": 123,
  "requestCountThreshold": 123,
  "excludedClients": ["xyz789"],
  "excludedOperations": ["xyz789"],
  "graphId": "4",
  "enabled": true
}

GraphOperationCheckConfigurationUpdatePayload

Example
GraphDoesNotExistError

GraphRemoveOwnerPayload

Example
GraphDoesNotExistError

GraphRemoveOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphScopeLimitExceededError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

GraphUpdateInput

Fields
Input Field Description
id - ID!
graphSlug - String
productionBranch - String
Example
{
  "id": "4",
  "graphSlug": "xyz789",
  "productionBranch": "abc123"
}

GraphUpdatePayload

GraphUpdateSuccess

Fields
Field Name Description
graph - Graph!
query - Query!
Example
{"graph": Graph, "query": Query}

HttpHeader

Fields
Field Name Description
name - String!
value - String!
Example
{
  "name": "abc123",
  "value": "xyz789"
}

HttpHeaderInput

Fields
Input Field Description
name - String!
value - String!
Example
{
  "name": "abc123",
  "value": "xyz789"
}

ID

Example
"4"

InboxMessage

Fields
Field Name Description
createdAt - DateTime!
id - ID!
readAt - DateTime
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "readAt": "2007-12-03T10:15:30Z"
}

Int

Example
987

InvalidAccountError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

InvalidEmailAddressError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Invite

Fields
Field Name Description
createdAt - DateTime!
email - String!
id - ID!
invitedBy - User!
lastRenewedAt - DateTime!
organization - Organization!
role - MemberRole!
status - InviteStatus!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "email": "xyz789",
  "id": 4,
  "invitedBy": User,
  "lastRenewedAt": "2007-12-03T10:15:30Z",
  "organization": Organization,
  "role": "OWNER",
  "status": "PENDING"
}

InviteAcceptInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

InviteAcceptPayload

InviteAcceptSuccess

Fields
Field Name Description
member - Member!
query - Query!
Example
{"member": Member, "query": Query}

InviteCancelInput

Fields
Input Field Description
id - ID!
Example
{"id": "4"}

InviteCancelPayload

Example
InviteCancelSuccess

InviteCancelSuccess

Fields
Field Name Description
inviteId - ID!
query - Query!
Example
{"inviteId": 4, "query": Query}

InviteConnection

Fields
Field Name Description
edges - [InviteEdge!]! A list of edges.
nodes - [Invite!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [InviteEdge],
  "nodes": [Invite],
  "pageInfo": PageInfo
}

InviteDeclineInput

Fields
Input Field Description
id - ID!
Example
{"id": "4"}

InviteDeclinePayload

Example
InviteDeclineSuccess

InviteDeclineSuccess

Fields
Field Name Description
inviteId - ID!
query - Query!
Example
{
  "inviteId": "4",
  "query": Query
}

InviteDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

InviteEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Invite! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Invite
}

InviteSendInput

Fields
Input Field Description
role - MemberRole!
email - String!
organizationId - ID!
Example
{
  "role": "OWNER",
  "email": "xyz789",
  "organizationId": "4"
}

InviteSendPayload

InviteSendSuccess

Fields
Field Name Description
invite - Invite!
query - Query!
Example
{"invite": Invite, "query": Query}

InviteStatus

Values
Enum Value Description

PENDING

EXPIRED

Example
"PENDING"

JSON

Description

A scalar that can represent any JSON value.

Example
{}

LintCheckError

Fields
Field Name Description
message - String!
severity - SchemaCheckErrorSeverity!
title - String!
Example
{
  "message": "abc123",
  "severity": "ERROR",
  "title": "abc123"
}

ManagedGraphsNoLongerSupportedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Member

Fields
Field Name Description
account - Account!
createdAt - DateTime!
id - ID!
role - MemberRole!
user - User!
Example
{
  "account": Account,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "role": "OWNER",
  "user": User
}

MemberConnection

Fields
Field Name Description
edges - [MemberEdge!]! A list of edges.
nodes - [Member!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [MemberEdge],
  "nodes": [Member],
  "pageInfo": PageInfo
}

MemberDeleteInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

MemberDeletePayload

Fields
Field Name Description
deletedMemberId - ID!
query - Query!
Example
{
  "deletedMemberId": "4",
  "query": Query
}

MemberEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Member! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Member
}

MemberRole

Values
Enum Value Description

OWNER

MEMBER

ADMIN

Example
"OWNER"

MemberUpdateInput

Fields
Input Field Description
id - ID!
role - MemberRole
Example
{"id": "4", "role": "OWNER"}

MemberUpdatePayload

Fields
Field Name Description
member - Member!
query - Query!
Example
{"member": Member, "query": Query}

NameSizeCheckError

Fields
Field Name Description
maxLength - Int!
message - String!
query - Query!
Example
{
  "maxLength": 123,
  "message": "abc123",
  "query": Query
}

Node

Fields
Field Name Description
id - ID!
Example
{"id": "4"}

NotAllowedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotAllowedToCancelInvitesError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotAllowedToDeleteOrganizationError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotAllowedToSendInvitesError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotAllowedToSlugUpdateError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotAllowedToUpdateOrganizationError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotEnterprisePlatformError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

NotificationsInbox

Fields
Field Name Description
messages - [InboxMessage!]!
Example
{"messages": [InboxMessage]}

NotificationsMarkAsReadPayload

Types
Union Types

NotificationsMarkAsReadSuccess

Example
NotificationsMarkAsReadSuccess

NotificationsMarkAsReadSuccess

Fields
Field Name Description
query - Query!
updated - Int! How many notifications were marked as read.
Example
{"query": Query, "updated": 987}

OldAccessTokenError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Operation

Fields
Field Name Description
id - ID!
name - String
normalizedQuery - String!
type - OperationType!
Example
{
  "id": 4,
  "name": "abc123",
  "normalizedQuery": "xyz789",
  "type": "QUERY"
}

OperationCheckError

Fields
Field Name Description
message - String!
severity - SchemaCheckErrorSeverity!
title - String!
Example
{
  "message": "abc123",
  "severity": "ERROR",
  "title": "xyz789"
}

OperationNormalizedQueryHash

Example
OperationNormalizedQueryHash

OperationType

Values
Enum Value Description

QUERY

MUTATION

SUBSCRIPTION

Example
"QUERY"

Organization

Fields
Field Name Description
accessTokens - AccessTokenConnection!
Arguments
after - String
before - String
first - Int
last - Int
addToSlackLink - String! The url for the UI button to install the Grafbase slack app. It is important to use this link and keep it private, since it contains the signed account id of the authenticated user.
createdAt - DateTime!
graphs - GraphConnection!
Arguments
after - String
before - String
first - Int
last - Int
id - ID!
invites - InviteConnection!
Arguments
after - String
before - String
first - Int
last - Int
members - MemberConnection!
Arguments
after - String
before - String
first - Int
last - Int
name - String!
plan - GrafbasePlan!
samlDomain - String
slackIntegration - SlackIntegration
slug - String!
status - AccountStatus!
teams - TeamConnection!
Arguments
after - String
first - Int
trialExpiresAt - DateTime
usage - AccountUsageTimeSeries
Arguments
filters - UsageFilters!
Example
{
  "accessTokens": AccessTokenConnection,
  "addToSlackLink": "abc123",
  "createdAt": "2007-12-03T10:15:30Z",
  "graphs": GraphConnection,
  "id": "4",
  "invites": InviteConnection,
  "members": MemberConnection,
  "name": "xyz789",
  "plan": "TRIAL",
  "samlDomain": "abc123",
  "slackIntegration": SlackIntegration,
  "slug": "xyz789",
  "status": AccountStatus,
  "teams": TeamConnection,
  "trialExpiresAt": "2007-12-03T10:15:30Z",
  "usage": AccountUsageTimeSeries
}

OrganizationConnection

Fields
Field Name Description
edges - [OrganizationEdge!]! A list of edges.
nodes - [Organization!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [OrganizationEdge],
  "nodes": [Organization],
  "pageInfo": PageInfo
}

OrganizationCreateInput

Fields
Input Field Description
name - String!
slug - String!
email - String
Example
{
  "name": "abc123",
  "slug": "xyz789",
  "email": "abc123"
}

OrganizationCreatePayload

OrganizationCreateSuccess

Fields
Field Name Description
member - Member!
organization - Organization!
query - Query!
Example
{
  "member": Member,
  "organization": Organization,
  "query": Query
}

OrganizationDeleteInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

OrganizationDeletePayload

Example
NotAllowedToDeleteOrganizationError

OrganizationDeleteSuccess

Fields
Field Name Description
deletedId - ID!
query - Query!
Example
{"deletedId": 4, "query": Query}

OrganizationDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

OrganizationEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Organization! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": Organization
}

OrganizationOwnershipNotTransferredError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

OrganizationSlugUpdateInput

Fields
Input Field Description
id - ID!
slug - String!
Example
{"id": 4, "slug": "abc123"}

OrganizationSlugUpdatePayload

OrganizationSlugUpdateSuccess

Fields
Field Name Description
organization - Organization!
query - Query!
Example
{
  "organization": Organization,
  "query": Query
}

OrganizationUpdateInput

Fields
Input Field Description
id - ID!
name - String
Example
{
  "id": "4",
  "name": "abc123"
}

OrganizationUpdatePayload

OrganizationUpdateSuccess

Fields
Field Name Description
organization - Organization!
query - Query!
Example
{
  "organization": Organization,
  "query": Query
}

PageInfo

Description

Information about pagination in a connection

Fields
Field Name Description
endCursor - String When paginating forwards, the cursor to continue.
hasNextPage - Boolean! When paginating forwards, are there more items?
hasPreviousPage - Boolean! When paginating backwards, are there more items?
startCursor - String When paginating backwards, the cursor to continue.
Example
{
  "endCursor": "xyz789",
  "hasNextPage": true,
  "hasPreviousPage": true,
  "startCursor": "xyz789"
}

PersonalAccountUpdateInput

Fields
Input Field Description
name - String!
Example
{"name": "abc123"}

PersonalAccountUpdatePayload

Example
NameSizeCheckError

PersonalAccountUpdateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ProposalCheckError

Fields
Field Name Description
message - String!
title - String!
Example
{
  "message": "abc123",
  "title": "abc123"
}

PublishDeploymentFailure

Fields
Field Name Description
deploymentError - String!
query - Query!
Example
{
  "deploymentError": "abc123",
  "query": Query
}

PublishForbidden

Fields
Field Name Description
query - Query!
Example
{"query": Query}

PublishInput

Fields
Input Field Description
schema - String!
accountSlug - String!
graphSlug - String
message - String
url - String
branch - String
subgraph - String!
Example
{
  "schema": "abc123",
  "accountSlug": "xyz789",
  "graphSlug": "xyz789",
  "message": "xyz789",
  "url": "abc123",
  "branch": "abc123",
  "subgraph": "abc123"
}

PublishNoChange

Description

Returned when the client tries to publish the same subgraph schema with the same url as already published. Such a publish does not result in a deployment.

Fields
Field Name Description
query - Query!
Example
{"query": Query}

PublishPayload

PublishSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Request

Fields
Field Name Description
clientName - String!
clientVersion - String!
endedAt - DateTime!
errorCount - Int!
errorCountByCode - [ErrorCountByCode!]!
httpRequestMethod - String!
httpStatusCode - Int!
id - ID!
operations - [RequestOperation!]!
rootSpanId - ID!
startedAt - DateTime!
trace - Trace!
urlPath - String!
userAgent - String!
Example
{
  "clientName": "abc123",
  "clientVersion": "abc123",
  "endedAt": "2007-12-03T10:15:30Z",
  "errorCount": 123,
  "errorCountByCode": [ErrorCountByCode],
  "httpRequestMethod": "xyz789",
  "httpStatusCode": 123,
  "id": "4",
  "operations": [RequestOperation],
  "rootSpanId": "4",
  "startedAt": "2007-12-03T10:15:30Z",
  "trace": Trace,
  "urlPath": "abc123",
  "userAgent": "abc123"
}

RequestConnection

Fields
Field Name Description
edges - [RequestEdge!]! A list of edges.
nodes - [Request!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [RequestEdge],
  "nodes": [Request],
  "pageInfo": PageInfo
}

RequestEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Request! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Request
}

RequestFilters

Fields
Input Field Description
branchName - String Defaults to production branch
duration - DurationFilter
range - Duration Use this if you really care about having a specific duration like 1 hour, 7 days, etc.
from - DateTime Use this if you at least the data between from and to to be provided. You may get more, but never less.
to - DateTime! To be used in conjunction with with either range or from.
traceId - [String!]
operationName - [String!]
clientName - [String!]
clientVersion - [String!] Only used if client name is specified.
httpStatusCode - [Int!]
operationType - [OperationType!]
errorCode - [String!]
Example
{
  "branchName": "abc123",
  "duration": DurationFilter,
  "range": "P3Y6M4DT12H30M5S",
  "from": "2007-12-03T10:15:30Z",
  "to": "2007-12-03T10:15:30Z",
  "traceId": ["abc123"],
  "operationName": ["abc123"],
  "clientName": ["abc123"],
  "clientVersion": ["xyz789"],
  "httpStatusCode": [987],
  "operationType": ["QUERY"],
  "errorCode": ["abc123"]
}

RequestMetricsTimeSeriesDataPointV2

Fields
Field Name Description
cacheHitCount - Int!
cacheMissCount - Int!
cachePassCount - Int!
count - Int!
dateTime - DateTime!
error4XxCount - Int!
error5XxCount - Int!
errorGraphqlCount - Int!
latencyMsPercentiles - [Int!]!
Example
{
  "cacheHitCount": 123,
  "cacheMissCount": 123,
  "cachePassCount": 987,
  "count": 987,
  "dateTime": "2007-12-03T10:15:30Z",
  "error4XxCount": 123,
  "error5XxCount": 987,
  "errorGraphqlCount": 123,
  "latencyMsPercentiles": [987]
}

RequestMetricsTimeSeriesV2

Fields
Field Name Description
overall - RequestMetricsV2!
points - [RequestMetricsTimeSeriesDataPointV2!]!
previousPeriod - RequestMetricsTimeSeriesV2
Example
{
  "overall": RequestMetricsV2,
  "points": [RequestMetricsTimeSeriesDataPointV2],
  "previousPeriod": RequestMetricsTimeSeriesV2
}

RequestMetricsV2

Fields
Field Name Description
cacheHitCount - Int!
cacheMissCount - Int!
cachePassCount - Int!
count - Int!
error4XxCount - Int!
error5XxCount - Int!
errorGraphqlCount - Int!
latencyMsPercentiles - [Int!]!
Example
{
  "cacheHitCount": 987,
  "cacheMissCount": 987,
  "cachePassCount": 123,
  "count": 123,
  "error4XxCount": 987,
  "error5XxCount": 987,
  "errorGraphqlCount": 123,
  "latencyMsPercentiles": [987]
}

RequestOperation

Fields
Field Name Description
name - String!
type - OperationType!
Example
{"name": "abc123", "type": "QUERY"}

ReservedSlugsCheckError

Fields
Field Name Description
message - String!
query - Query!
Example
{
  "message": "xyz789",
  "query": Query
}

ReusedId

Description

An occurrence of a trusted document that was submitted again (same id), but with a different document text. This is an error.

Fields
Field Name Description
documentId - String! The document id
existingDocumentText - String! The existing document body
newDocumentText - String! The different, newly submitted document body
Example
{
  "documentId": "abc123",
  "existingDocumentText": "xyz789",
  "newDocumentText": "abc123"
}

ReusedIds

Description

Trusted documents that were uploaded again (same id), but with a different document body. This is an error.

Fields
Field Name Description
reused - [ReusedId!]!
Example
{"reused": [ReusedId]}

ReviewerDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaChangeType

Values
Enum Value Description

SCHEMA_DEFINITION_ADDED

SCHEMA_DEFINITION_REMOVED

SCHEMA_EXTENSION_ADDED

SCHEMA_EXTENSION_REMOVED

FIELD_ARGUMENT_DEFAULT_ADDED

FIELD_ARGUMENT_DEFAULT_REMOVED

FIELD_ARGUMENT_DESCRIPTION_CHANGED

FIELD_ARGUMENT_DEFAULT_CHANGED

FIELD_ARGUMENT_TYPE_CHANGED

DIRECTIVE_REMOVED

DIRECTIVE_ADDED

DIRECTIVE_DESCRIPTION_CHANGED

DIRECTIVE_LOCATION_ADDED

DIRECTIVE_LOCATION_REMOVED

DIRECTIVE_ARGUMENT_ADDED

DIRECTIVE_ARGUMENT_REMOVED

DIRECTIVE_ARGUMENT_DESCRIPTION_CHANGED

DIRECTIVE_ARGUMENT_DEFAULT_VALUE_CHANGED

DIRECTIVE_ARGUMENT_TYPE_CHANGED

ENUM_ADDED

ENUM_REMOVED

ENUM_VALUE_REMOVED

ENUM_VALUE_ADDED

ENUM_VALUE_DESCRIPTION_CHANGED

ENUM_VALUE_DEPRECATION_REASON_CHANGED

ENUM_VALUE_DEPRECATION_REASON_ADDED

ENUM_VALUE_DEPRECATION_REASON_REMOVED

FIELD_REMOVED

FIELD_ADDED

FIELD_DESCRIPTION_CHANGED

FIELD_DESCRIPTION_ADDED

FIELD_DESCRIPTION_REMOVED

FIELD_DEPRECATION_ADDED

FIELD_DEPRECATION_REMOVED

FIELD_DEPRECATION_REASON_CHANGED

FIELD_DEPRECATION_REASON_ADDED

FIELD_DEPRECATION_REASON_REMOVED

FIELD_TYPE_CHANGED

FIELD_ARGUMENT_ADDED

FIELD_ARGUMENT_REMOVED

INPUT_OBJECT_REMOVED

INPUT_OBJECT_ADDED

INPUT_FIELD_REMOVED

INPUT_FIELD_ADDED

INPUT_FIELD_DESCRIPTION_ADDED

INPUT_FIELD_DESCRIPTION_REMOVED

INPUT_FIELD_DESCRIPTION_CHANGED

INPUT_FIELD_DEFAULT_VALUE_CHANGED

INPUT_FIELD_TYPE_CHANGED

OBJECT_TYPE_INTERFACE_ADDED

OBJECT_TYPE_INTERFACE_REMOVED

SCHEMA_QUERY_TYPE_CHANGED

SCHEMA_MUTATION_TYPE_CHANGED

SCHEMA_SUBSCRIPTION_TYPE_CHANGED

TYPE_REMOVED

TYPE_ADDED

TYPE_KIND_CHANGED

TYPE_DESCRIPTION_CHANGED

TYPE_DESCRIPTION_REMOVED

TYPE_DESCRIPTION_ADDED

UNION_ADDED

UNION_REMOVED

UNION_MEMBER_REMOVED

UNION_MEMBER_ADDED

INTERFACE_ADDED

INTERFACE_REMOVED

INTERFACE_IMPLEMENTATION_ADDED

INTERFACE_IMPLEMENTATION_REMOVED

SCALAR_ADDED

SCALAR_REMOVED

Example
"SCHEMA_DEFINITION_ADDED"

SchemaCheck

Fields
Field Name Description
compositionCheckErrors - [CompositionCheckError!]! Replaced by SchemaCheck.diagnostics
createdAt - DateTime!
diagnostics - [SchemaCheckDiagnostic!]!
errorCount - Int!
gitCommit - SchemaCheckGitCommit
id - ID!
lintCheckErrors - [LintCheckError!]! Replaced by SchemaCheck.diagnostics
operationCheckErrors - [OperationCheckError!]! Replaced by SchemaCheck.diagnostics
proposalCheckErrors - [ProposalCheckError!]! Replaced by SchemaCheck.diagnostics
schema - String!
subgraphName - String
validationCheckErrors - [ValidationCheckError!]! Replaced by SchemaCheck.diagnostics
Example
{
  "compositionCheckErrors": [CompositionCheckError],
  "createdAt": "2007-12-03T10:15:30Z",
  "diagnostics": [SchemaCheckDiagnostic],
  "errorCount": 123,
  "gitCommit": SchemaCheckGitCommit,
  "id": "4",
  "lintCheckErrors": [LintCheckError],
  "operationCheckErrors": [OperationCheckError],
  "proposalCheckErrors": [ProposalCheckError],
  "schema": "xyz789",
  "subgraphName": "abc123",
  "validationCheckErrors": [ValidationCheckError]
}

SchemaCheckConnection

Fields
Field Name Description
edges - [SchemaCheckEdge!]! A list of edges.
nodes - [SchemaCheck!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [SchemaCheckEdge],
  "nodes": [SchemaCheck],
  "pageInfo": PageInfo
}

SchemaCheckCreateInput

Fields
Input Field Description
schema - String!
accountSlug - String!
graphSlug - String!
branch - String
subgraphName - String!
gitCommit - SchemaCheckGitCommitInput
Example
{
  "schema": "abc123",
  "accountSlug": "abc123",
  "graphSlug": "xyz789",
  "branch": "abc123",
  "subgraphName": "abc123",
  "gitCommit": SchemaCheckGitCommitInput
}

SchemaCheckCustomWebhookCreateInput

Fields
Input Field Description
url - Url! The webhook URL that will be called when a schema check is created.
headers - [HttpHeaderInput!] The headers to be sent with the webhook request.
graphId - ID! The graph the schema checks apply to.
Example
{
  "url": Url,
  "headers": [HttpHeaderInput],
  "graphId": 4
}

SchemaCheckCustomWebhookCreatePayload

Example
SchemaCheckCustomWebhookCreateSuccess

SchemaCheckCustomWebhookCreateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaCheckCustomWebhookDeletePayload

Example
CustomCheckWebhookNotFoundError

SchemaCheckCustomWebhookDeleteSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaCheckCustomWebhookUpdateInput

Fields
Input Field Description
headers - [HttpHeaderInput!]
webhookId - ID!
Example
{
  "headers": [HttpHeaderInput],
  "webhookId": "4"
}

SchemaCheckCustomWebhookUpdatePayload

Example
SchemaCheckCustomWebhookUpdateSuccess

SchemaCheckCustomWebhookUpdateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaCheckDiagnostic

Fields
Field Name Description
message - String!
severity - SchemaCheckErrorSeverity!
step - SchemaCheckStep!
Example
{
  "message": "abc123",
  "severity": "ERROR",
  "step": "VALIDATION"
}

SchemaCheckEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - SchemaCheck! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": SchemaCheck
}

SchemaCheckErrorSeverity

Values
Enum Value Description

ERROR

WARNING

Example
"ERROR"

SchemaCheckGitCommit

Fields
Field Name Description
authorAvatarUrl - String
authorName - String!
branch - String!
commitSha - String!
commitUrl - String
message - String!
Example
{
  "authorAvatarUrl": "xyz789",
  "authorName": "xyz789",
  "branch": "xyz789",
  "commitSha": "abc123",
  "commitUrl": "xyz789",
  "message": "abc123"
}

SchemaCheckGitCommitInput

Fields
Input Field Description
message - String!
branch - String!
commitSha - String!
commitUrl - String
authorName - String!
authorAvatarUrl - String
Example
{
  "message": "xyz789",
  "branch": "xyz789",
  "commitSha": "xyz789",
  "commitUrl": "abc123",
  "authorName": "xyz789",
  "authorAvatarUrl": "xyz789"
}

SchemaCheckPayload

SchemaCheckStep

Values
Enum Value Description

VALIDATION

COMPOSITION

OPERATION

LINT

PROPOSAL

CUSTOM

Example
"VALIDATION"

SchemaProposal

Fields
Field Name Description
activityFeed - [SchemaProposalActivityFeedItem!]! The whole activity feed.
author - User
branch - Branch
comments - [SchemaProposalComment!]!
createdAt - DateTime!
description - String
id - ID!
reviewers - [SchemaProposalReviewer!]!

All the reviewers and their status.

It will return all users that:

  • Have been configured as reviewers for the branch of the proposal.
  • Have been requested to review the proposal.
  • Have reviewed the proposal.

And all the teams that have been configured or requested, but where the review is pending. This does not return teams that have already have a review status, because are returned in SchemaProposalReviewerUser.onBehalfOf.

revision - Int! The revision number of the proposal, i.e. how many times edits were applied to the proposal's subgraphs.
status - SchemaProposalStatus!
subgraph - SchemaProposalSubgraph
Arguments
subgraphName - String!
subgraphs - [SchemaProposalSubgraph!]!
title - String!
viewerIsReviewer - Boolean! Is the currently logged in user a reviewer of this proposal? That is to say, eitheir they are configured as a reviewer, or
Example
{
  "activityFeed": [SchemaProposalActivityFeedItem],
  "author": User,
  "branch": Branch,
  "comments": [SchemaProposalComment],
  "createdAt": "2007-12-03T10:15:30Z",
  "description": "abc123",
  "id": 4,
  "reviewers": [SchemaProposalReviewerTeam],
  "revision": 123,
  "status": "APPROVED",
  "subgraph": SchemaProposalSubgraph,
  "subgraphs": [SchemaProposalSubgraph],
  "title": "abc123",
  "viewerIsReviewer": true
}

SchemaProposalActivityFeedItem

Example
{"createdAt": "2007-12-03T10:15:30Z"}

SchemaProposalApproval

Fields
Field Name Description
author - User
createdAt - DateTime!
id - ID!
message - String
schemaProposal - SchemaProposal!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": "4",
  "message": "xyz789",
  "schemaProposal": SchemaProposal
}

SchemaProposalApproveInput

Fields
Input Field Description
id - ID!
message - String
Example
{
  "id": "4",
  "message": "xyz789"
}

SchemaProposalApprovePayload

Example
SchemaProposalApproveSuccess

SchemaProposalApproveSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalComment

Fields
Field Name Description
author - User
createdAt - DateTime!
id - ID!
text - String!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "text": "abc123"
}

SchemaProposalCommentOnLine

Fields
Field Name Description
author - User Who wrote the comment. Will be null in case the user was deleted.
context - String The section of the subgraph SDL where the comment is located.
Arguments
contextLines - Int!

How many lines around the commented line to include. Fewer lines can be returned if the context reaches the start or the end of the schema.

createdAt - DateTime!
diffSide - DiffSide!
id - ID!
line - Int

Which line the comment applies to in the subgraph SDL. This may be null if the comment was on an item that is no longer part of the current subgraph schema.

The line is 1-indexes

path - String! The logical path in the schema where the comment is located. This is only exposed for debugging, prefer using the line field.
replies - [SchemaProposalReply!]! All the replies in chronological order, from oldest to newest.
resolved - Boolean! Is this comment thread resolved?
resolvedBy - User The user who marked the thread as resolved.
subgraphName - String! Which subgraph the comment applies to.
text - String! The content of the comment.
Example
{
  "author": User,
  "context": "abc123",
  "createdAt": "2007-12-03T10:15:30Z",
  "diffSide": "OLD",
  "id": 4,
  "line": 123,
  "path": "abc123",
  "replies": [SchemaProposalReply],
  "resolved": true,
  "resolvedBy": User,
  "subgraphName": "abc123",
  "text": "xyz789"
}

SchemaProposalCommentOnProposal

Fields
Field Name Description
author - User Who wrote the comment. Will be null in case the user was deleted.
createdAt - DateTime!
id - ID!
replies - [SchemaProposalReply!]!
text - String!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "replies": [SchemaProposalReply],
  "text": "abc123"
}

SchemaProposalCommentOnSdl

Fields
Field Name Description
author - User
createdAt - DateTime!
id - ID!
replies - [SchemaProposalReply!]!
resolved - Boolean! Is this comment thread resolved?
resolvedBy - User The user who marked the thread as resolved.
text - String!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "replies": [SchemaProposalReply],
  "resolved": false,
  "resolvedBy": User,
  "text": "xyz789"
}

SchemaProposalCommentReplyPayload

Example
SchemaProposalCommentReplySuccess

SchemaProposalCommentReplySuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalCommentThreadCreateInput

Fields
Input Field Description
schemaProposalId - ID! The parent schema proposal.
text - String! The content of the comment.
subgraphName - String Must be provided if and only if location is Line.
line - Int Must be provided if and only if location is Line.
diffSide - DiffSide

Whether the comment applies to the existing or the proposed schema.

Must be provided if and only if location is Line.

location - SchemaProposalCommentThreadLocation! Where the comment is located.
proposalRevision - Int

The revision / version number of the proposal, obtained from SchemaProposal.revision. Must be provided if and only if location is Line.

This argument is necessary to avoid cases where the schema has been updated between the time it was retried and the time the comment is posted. In these cases, if we use the latest subgraph schema, the line numbers may have changed and the comment would end up in the wrong place.

Example
{
  "schemaProposalId": "4",
  "text": "xyz789",
  "subgraphName": "xyz789",
  "line": 123,
  "diffSide": "OLD",
  "location": "PROPOSAL",
  "proposalRevision": 123
}

SchemaProposalCommentThreadCreatePayload

Example
SchemaProposalCommentThreadCreateSuccess

SchemaProposalCommentThreadCreateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalCommentThreadLocation

Values
Enum Value Description

PROPOSAL

LINE

SDL

Example
"PROPOSAL"

SchemaProposalCommentThreadResolvePayload

Example
SchemaProposalCommentThreadResolveSuccess

SchemaProposalCommentThreadResolveSuccess

Fields
Field Name Description
affectedRows - Int!
query - Query!
Example
{"affectedRows": 123, "query": Query}

SchemaProposalCommentThreadUnresolvePayload

Example
SchemaProposalCommentThreadUnresolveSuccess

SchemaProposalCommentThreadUnresolveSuccess

Fields
Field Name Description
affectedRows - Int!
query - Query!
Example
{"affectedRows": 987, "query": Query}

SchemaProposalConnection

Fields
Field Name Description
edges - [SchemaProposalEdge!]! A list of edges.
nodes - [SchemaProposal!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [SchemaProposalEdge],
  "nodes": [SchemaProposal],
  "pageInfo": PageInfo
}

SchemaProposalCreateInput

Fields
Input Field Description
title - String!
description - String
branchId - ID!
Example
{
  "title": "abc123",
  "description": "abc123",
  "branchId": "4"
}

SchemaProposalCreatePayload

Types
Union Types

SchemaProposalCreateSuccess

Example
SchemaProposalCreateSuccess

SchemaProposalCreateSuccess

Fields
Field Name Description
query - Query!
schemaProposal - SchemaProposal!
Example
{
  "query": Query,
  "schemaProposal": SchemaProposal
}

SchemaProposalDeletePayload

Example
SchemaProposalDeleteSuccess

SchemaProposalDeleteSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - SchemaProposal! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": SchemaProposal
}

SchemaProposalEditInput

Fields
Input Field Description
subgraphs - [SchemaProposalEditSubgraph!]!
description - String
schemaProposalId - ID!
Example
{
  "subgraphs": [SchemaProposalEditSubgraph],
  "description": "xyz789",
  "schemaProposalId": 4
}

SchemaProposalEditParserError

Fields
Field Name Description
error - String!
spanEnd - Int!
spanStart - Int!
subgraphName - String!
Example
{
  "error": "xyz789",
  "spanEnd": 987,
  "spanStart": 123,
  "subgraphName": "xyz789"
}

SchemaProposalEditParserErrors

Fields
Field Name Description
errors - [SchemaProposalEditParserError!]!
Example
{"errors": [SchemaProposalEditParserError]}

SchemaProposalEditPayload

Example
SchemaProposalDoesNotExistError

SchemaProposalEditSubgraph

Fields
Input Field Description
name - String!
schema - String
Example
{
  "name": "abc123",
  "schema": "abc123"
}

SchemaProposalEditSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalFilter

Fields
Input Field Description
status - SchemaProposalStatus
Example
{"status": "APPROVED"}

SchemaProposalRejectInput

Fields
Input Field Description
id - ID!
message - String
Example
{
  "id": "4",
  "message": "abc123"
}

SchemaProposalRejectPayload

Example
SchemaProposalDoesNotExistError

SchemaProposalRejectSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalRejection

Fields
Field Name Description
author - User
createdAt - DateTime!
id - ID!
message - String
schemaProposal - SchemaProposal!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": "4",
  "message": "abc123",
  "schemaProposal": SchemaProposal
}

SchemaProposalReply

Fields
Field Name Description
author - User Who wrote the comment. Will be null in case the user was deleted.
createdAt - DateTime!
id - ID!
text - String!
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "text": "abc123"
}

SchemaProposalRequestReviewInput

Fields
Input Field Description
id - ID!
Example
{"id": 4}

SchemaProposalRequestReviewPayload

Example
SchemaProposalDoesNotExistError

SchemaProposalRequestReviewSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalRevertToDraftPayload

Example
SchemaProposalDoesNotExistError

SchemaProposalRevertToDraftSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalReview

Fields
Field Name Description
author - User
createdAt - DateTime!
id - ID!
schemaProposal - SchemaProposal!
Possible Types
SchemaProposalReview Types

SchemaProposalApproval

SchemaProposalRejection

Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "id": "4",
  "schemaProposal": SchemaProposal
}

SchemaProposalReviewNotification

Fields
Field Name Description
createdAt - DateTime!
id - ID!
readAt - DateTime
review - SchemaProposalReview!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "readAt": "2007-12-03T10:15:30Z",
  "review": SchemaProposalReview
}

SchemaProposalReviewRequest

Fields
Field Name Description
createdAt - DateTime!
id - ID!
requestFor - UserOrTeam!
requestedBy - ID!
schemaProposal - SchemaProposal!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "requestFor": Team,
  "requestedBy": "4",
  "schemaProposal": SchemaProposal
}

SchemaProposalReviewRequestCreateInput

Fields
Input Field Description
schemaProposalId - ID!
reviewerId - ID! Must be either a team id or a user id.
Example
{"schemaProposalId": 4, "reviewerId": 4}

SchemaProposalReviewRequestCreatePayload

Example
SchemaProposalDoesNotExistError

SchemaProposalReviewRequestCreateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalReviewRequestNotification

Fields
Field Name Description
createdAt - DateTime!
id - ID!
readAt - DateTime
reviewRequest - SchemaProposalReviewRequest!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "readAt": "2007-12-03T10:15:30Z",
  "reviewRequest": SchemaProposalReviewRequest
}

SchemaProposalReviewer

Example
SchemaProposalReviewerTeam

SchemaProposalReviewerStatus

Values
Enum Value Description

PENDING

APPROVED

REJECTED

Example
"PENDING"

SchemaProposalReviewerTeam

Fields
Field Name Description
team - Team!
Example
{"team": Team}

SchemaProposalReviewerUser

Fields
Field Name Description
onBehalfOf - [Team!]! The teams that were requested or configured for review that the user reviewed on behalf of.
status - SchemaProposalReviewerStatus!
user - User!
Example
{
  "onBehalfOf": [Team],
  "status": "PENDING",
  "user": User
}

SchemaProposalRevision

Fields
Field Name Description
author - User The author of the revision.
createdAt - DateTime!
description - String The message entered when the author saved changes.
Example
{
  "author": User,
  "createdAt": "2007-12-03T10:15:30Z",
  "description": "abc123"
}

SchemaProposalStatus

Values
Enum Value Description

APPROVED

REJECTED

DRAFT

IMPLEMENTED

IN_REVIEW

Example
"APPROVED"

SchemaProposalStatusChange

Fields
Field Name Description
createdAt - DateTime!
fromStatus - SchemaProposalStatus!
schemaProposal - SchemaProposal!
toStatus - SchemaProposalStatus!
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "fromStatus": "APPROVED",
  "schemaProposal": SchemaProposal,
  "toStatus": "APPROVED"
}

SchemaProposalStatusChangeNotification

Fields
Field Name Description
createdAt - DateTime!
id - ID!
readAt - DateTime
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "id": "4",
  "readAt": "2007-12-03T10:15:30Z"
}

SchemaProposalSubgraph

Fields
Field Name Description
comments - [SchemaProposalComment!]!
diffSnippets - [DiffSnippet!]!
name - String!
sdl - String
status - SchemaProposalSubgraphStatus!
Example
{
  "comments": [SchemaProposalComment],
  "diffSnippets": [DiffSnippet],
  "name": "abc123",
  "sdl": "xyz789",
  "status": "CREATED"
}

SchemaProposalSubgraphStatus

Values
Enum Value Description

CREATED

EDITED

DELETED

UNCHANGED

Example
"CREATED"

SchemaProposalUpdateInput

Fields
Input Field Description
title - String
description - String
schemaProposalId - ID!
Example
{
  "title": "abc123",
  "description": "xyz789",
  "schemaProposalId": 4
}

SchemaProposalUpdatePayload

Example
SchemaProposalDoesNotExistError

SchemaProposalUpdateSuccess

Fields
Field Name Description
query - Query!
schemaProposal - SchemaProposal!
Example
{
  "query": Query,
  "schemaProposal": SchemaProposal
}

SchemaProposalsConfiguration

Fields
Field Name Description
configuredReviewers - [SchemaProposalsConfiguredReviewers!]!
enforceChecks - Boolean!
keepApprovalsOnEdit - Boolean!
requireApprovalFromSubgraphOwners - Boolean!
Example
{
  "configuredReviewers": [
    SchemaProposalsConfiguredReviewerTeam
  ],
  "enforceChecks": false,
  "keepApprovalsOnEdit": false,
  "requireApprovalFromSubgraphOwners": true
}

SchemaProposalsConfigurationUpdateInput

Fields
Input Field Description
enforceChecks - Boolean
requireApprovalFromSubgraphOwners - Boolean
keepApprovalsOnEdit - Boolean
Example
{
  "enforceChecks": true,
  "requireApprovalFromSubgraphOwners": false,
  "keepApprovalsOnEdit": false
}

SchemaProposalsConfiguredReviewerAddInput

Fields
Input Field Description
branchId - ID!
reviewerId - ID! Either a UserId or a TeamId
Example
{"branchId": "4", "reviewerId": 4}

SchemaProposalsConfiguredReviewerAddPayload

SchemaProposalsConfiguredReviewerAddSuccess

Fields
Field Name Description
query - Query!
reviewer - SchemaProposalsConfiguredReviewers!
Example
{
  "query": Query,
  "reviewer": SchemaProposalsConfiguredReviewerTeam
}

SchemaProposalsConfiguredReviewerRemoveInput

Fields
Input Field Description
branchId - ID!
reviewerId - ID! Either a SchemaProposalUserReviewerId or a SchemaProposalTeamReviewerId
Example
{"branchId": "4", "reviewerId": 4}

SchemaProposalsConfiguredReviewerRemovePayload

SchemaProposalsConfiguredReviewerRemoveSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaProposalsConfiguredReviewerTeam

Fields
Field Name Description
id - ID!
team - Team!
Example
{"id": 4, "team": Team}

SchemaProposalsConfiguredReviewerUser

Fields
Field Name Description
id - ID!
user - User!
Example
{
  "id": "4",
  "user": User
}

SchemaProposalsConfiguredReviewers

Description

A (required) schema proposal reviewer in the branch configuration.

Example
SchemaProposalsConfiguredReviewerTeam

SchemaRegistryBranchDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SchemaVersion

Fields
Field Name Description
changes - SchemaVersionChangeConnection!
Arguments
after - String
before - String
first - Int
last - Int
createdAt - DateTime!
delta - SchemaVersionDelta!
id - ID!
message - String
schema - String!
subgraph - Subgraph
Example
{
  "changes": SchemaVersionChangeConnection,
  "createdAt": "2007-12-03T10:15:30Z",
  "delta": SchemaVersionDelta,
  "id": 4,
  "message": "xyz789",
  "schema": "xyz789",
  "subgraph": Subgraph
}

SchemaVersionChange

Fields
Field Name Description
message - String!
path - String
type - SchemaChangeType!
Example
{
  "message": "xyz789",
  "path": "abc123",
  "type": "SCHEMA_DEFINITION_ADDED"
}

SchemaVersionChangeConnection

Fields
Field Name Description
edges - [SchemaVersionChangeEdge!]! A list of edges.
nodes - [SchemaVersionChange!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [SchemaVersionChangeEdge],
  "nodes": [SchemaVersionChange],
  "pageInfo": PageInfo
}

SchemaVersionChangeEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - SchemaVersionChange! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": SchemaVersionChange
}

SchemaVersionConnection

Fields
Field Name Description
edges - [SchemaVersionEdge!]! A list of edges.
nodes - [SchemaVersion!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [SchemaVersionEdge],
  "nodes": [SchemaVersion],
  "pageInfo": PageInfo
}

SchemaVersionDelta

Fields
Field Name Description
added - Int! Additions.
modified - Int! Modifications.
removed - Int! Removals.
Example
{"added": 123, "modified": 123, "removed": 987}

SchemaVersionEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - SchemaVersion! The item at the end of the edge
Example
{
  "cursor": "xyz789",
  "node": SchemaVersion
}

SemverVersion

Example
SemverVersion

SemverVersionRequirement

Example
SemverVersionRequirement

SlackChannel

Description

A Slack channel returned from the Slack API.

Fields
Field Name Description
id - String!
name - String!
Example
{
  "id": "abc123",
  "name": "xyz789"
}

SlackIntegration

Fields
Field Name Description
availableChannels - [SlackChannel!]!
notifications - [SlackNotification!]!
Example
{
  "availableChannels": [SlackChannel],
  "notifications": [SlackNotification]
}

SlackIntegrationCreateInput

Fields
Input Field Description
graphId - String The graph_id field is deprecated. Pass branch_id instead.
branchId - ID
tokenId - String!
channelId - String!
channelName - String!
Example
{
  "graphId": "abc123",
  "branchId": 4,
  "tokenId": "abc123",
  "channelId": "abc123",
  "channelName": "xyz789"
}

SlackNotification

Fields
Field Name Description
branchId - String!
channelName - String!
graphId - String! Graphs are being removed. Please use SlackNotification.branch_id instead
id - String!
Example
{
  "branchId": "xyz789",
  "channelName": "abc123",
  "graphId": "xyz789",
  "id": "xyz789"
}

SlackNotificationCreatePayload

Example
GraphDoesNotExistError

SlackNotificationDeletePayload

Types
Union Types

Query

Example
Query

SlugAlreadyExistsError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SlugError

Fields
Field Name Description
actual - String!
expected - String!
message - String!
query - Query!
Example
{
  "actual": "xyz789",
  "expected": "xyz789",
  "message": "xyz789",
  "query": Query
}

SlugInvalidError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SlugSizeCheckError

Fields
Field Name Description
maxLength - Int!
message - String!
query - Query!
Example
{
  "maxLength": 987,
  "message": "xyz789",
  "query": Query
}

SlugTooLongError

Fields
Field Name Description
maxLength - Int!
query - Query!
Example
{"maxLength": 123, "query": Query}

StandaloneGraphsNoLongerSupportedError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

String

Example
"xyz789"

Subgraph

Fields
Field Name Description
createdAt - DateTime!
name - String!
owners - [Team!]!
schema - String!
updatedAt - DateTime!
url - String
Example
{
  "createdAt": "2007-12-03T10:15:30Z",
  "name": "xyz789",
  "owners": [Team],
  "schema": "abc123",
  "updatedAt": "2007-12-03T10:15:30Z",
  "url": "xyz789"
}

SubgraphAddOwnerPayload

Types
Union Types

SubgraphAddOwnerSuccess

Example
SubgraphAddOwnerSuccess

SubgraphAddOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SubgraphNameMissingOnFederatedGraphError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SubgraphNotFoundError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

SubgraphRemoveOwnerPayload

Types
Union Types

SubgraphRemoveOwnerSuccess

Example
SubgraphRemoveOwnerSuccess

SubgraphRemoveOwnerSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

Team

Fields
Field Name Description
id - ID!
members - UserConnection! The users that are part of the team
Arguments
after - String
first - Int
name - String!
parent - Team The team this team is member of, if any.
parentTeamId - ID
query - Query!
slug - String!
subteams - TeamConnection! The teams that are part of the team
Arguments
after - String
first - Int
Example
{
  "id": "4",
  "members": UserConnection,
  "name": "xyz789",
  "parent": Team,
  "parentTeamId": "4",
  "query": Query,
  "slug": "xyz789",
  "subteams": TeamConnection
}

TeamAddMemberPayload

Example
TeamAddMemberSuccess

TeamAddMemberSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamAssignRolePayload

Example
TeamAssignRoleSuccess

TeamAssignRoleSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamConnection

Fields
Field Name Description
edges - [TeamEdge!]! A list of edges.
nodes - [Team!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
Example
{
  "edges": [TeamEdge],
  "nodes": [Team],
  "pageInfo": PageInfo
}

TeamCreatePayload

Example
OrganizationDoesNotExistError

TeamDeletePayload

Example
TeamDeleteSuccess

TeamDeleteSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - Team! The item at the end of the edge
Example
{
  "cursor": "abc123",
  "node": Team
}

TeamNameAlreadyTakenError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamRemoveMemberPayload

Example
TeamDoesNotExistError

TeamRemoveMemberSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TeamRole

Values
Enum Value Description

MEMBER

ADMIN

Example
"MEMBER"

TokenDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TokenLimitExceededError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TopClientByNameAndVersionOrderedByHighestCount

Fields
Field Name Description
count - Int!
name - String!
version - String!
Example
{
  "count": 123,
  "name": "abc123",
  "version": "xyz789"
}

TopClientByNameAndVersionOrderedByHighestErrorRatio

Fields
Field Name Description
count - Int!
errorCount - Int!
name - String!
version - String!
Example
{
  "count": 123,
  "errorCount": 123,
  "name": "xyz789",
  "version": "xyz789"
}

TopClientByNameAndVersionOrderedByHighestLatency

Fields
Field Name Description
latencyMs - Int!
name - String!
version - String!
Example
{
  "latencyMs": 987,
  "name": "abc123",
  "version": "abc123"
}

TopClientByNameOrderedByHighestCount

Fields
Field Name Description
count - Int!
name - String!
Example
{"count": 123, "name": "xyz789"}

TopClientByNameOrderedByHighestErrorRatio

Fields
Field Name Description
count - Int!
errorCount - Int!
name - String!
Example
{
  "count": 987,
  "errorCount": 123,
  "name": "xyz789"
}

TopClientByNameOrderedByHighestLatency

Fields
Field Name Description
latencyMs - Int!
name - String!
Example
{"latencyMs": 123, "name": "xyz789"}

TopClients

Fields
Field Name Description
byName - TopClientsByName!
byNameAndVersion - TopClientsByNameAndVersion!
Example
{
  "byName": TopClientsByName,
  "byNameAndVersion": TopClientsByNameAndVersion
}

TopClientsByName

Fields
Field Name Description
orderedByHighestCount - [TopClientByNameOrderedByHighestCount!]!
orderedByHighestErrorRatio - [TopClientByNameOrderedByHighestErrorRatio!]!
orderedByHighestLatency - [TopClientByNameOrderedByHighestLatency!]!
Example
{
  "orderedByHighestCount": [
    TopClientByNameOrderedByHighestCount
  ],
  "orderedByHighestErrorRatio": [
    TopClientByNameOrderedByHighestErrorRatio
  ],
  "orderedByHighestLatency": [
    TopClientByNameOrderedByHighestLatency
  ]
}

TopClientsByNameAndVersion

Fields
Field Name Description
orderedByHighestCount - [TopClientByNameAndVersionOrderedByHighestCount!]!
orderedByHighestErrorRatio - [TopClientByNameAndVersionOrderedByHighestErrorRatio!]!
orderedByHighestLatency - [TopClientByNameAndVersionOrderedByHighestLatency!]!
Example
{
  "orderedByHighestCount": [
    TopClientByNameAndVersionOrderedByHighestCount
  ],
  "orderedByHighestErrorRatio": [
    TopClientByNameAndVersionOrderedByHighestErrorRatio
  ],
  "orderedByHighestLatency": [
    TopClientByNameAndVersionOrderedByHighestLatency
  ]
}

TopClientsForField

Fields
Field Name Description
byName - TopClientsForFieldByName!
byNameAndVersion - TopClientsForFieldByNameAndVersion!
Example
{
  "byName": TopClientsForFieldByName,
  "byNameAndVersion": TopClientsForFieldByNameAndVersion
}

TopClientsForFieldByName

Fields
Field Name Description
orderedByHighestCount - [TopClientByNameOrderedByHighestCount!]!
Example
{
  "orderedByHighestCount": [
    TopClientByNameOrderedByHighestCount
  ]
}

TopClientsForFieldByNameAndVersion

Fields
Field Name Description
orderedByHighestCount - [TopClientByNameAndVersionOrderedByHighestCount!]!
Example
{
  "orderedByHighestCount": [
    TopClientByNameAndVersionOrderedByHighestCount
  ]
}

TopOperationByNameAndHashOrderedByHighestCount

Fields
Field Name Description
count - Int!
name - String!
normalizedQueryHash - OperationNormalizedQueryHash!
Example
{
  "count": 123,
  "name": "xyz789",
  "normalizedQueryHash": OperationNormalizedQueryHash
}

TopOperationByNameAndHashOrderedByHighestErrorRatio

Fields
Field Name Description
count - Int!
errorCount - Int!
name - String!
normalizedQueryHash - OperationNormalizedQueryHash!
Example
{
  "count": 123,
  "errorCount": 123,
  "name": "xyz789",
  "normalizedQueryHash": OperationNormalizedQueryHash
}

TopOperationByNameAndHashOrderedByHighestLatency

Fields
Field Name Description
latencyMs - Int!
name - String!
normalizedQueryHash - OperationNormalizedQueryHash!
Example
{
  "latencyMs": 987,
  "name": "abc123",
  "normalizedQueryHash": OperationNormalizedQueryHash
}

TopOperationByNameOrderedByHighestCount

Fields
Field Name Description
count - Int!
name - String!
Example
{"count": 987, "name": "xyz789"}

TopOperationByNameOrderedByHighestErrorRatio

Fields
Field Name Description
count - Int!
errorCount - Int!
name - String!
Example
{
  "count": 987,
  "errorCount": 123,
  "name": "abc123"
}

TopOperationByNameOrderedByHighestLatency

Fields
Field Name Description
latencyMs - Int!
name - String!
Example
{"latencyMs": 123, "name": "abc123"}

TopOperations

Fields
Field Name Description
byName - TopOperationsByName!
byNameAndHash - TopOperationsByNameAndHash!
Example
{
  "byName": TopOperationsByName,
  "byNameAndHash": TopOperationsByNameAndHash
}

TopOperationsByName

Fields
Field Name Description
orderedByHighestCount - [TopOperationByNameOrderedByHighestCount!]!
orderedByHighestErrorRatio - [TopOperationByNameOrderedByHighestErrorRatio!]!
orderedByHighestLatency - [TopOperationByNameOrderedByHighestLatency!]!
Example
{
  "orderedByHighestCount": [
    TopOperationByNameOrderedByHighestCount
  ],
  "orderedByHighestErrorRatio": [
    TopOperationByNameOrderedByHighestErrorRatio
  ],
  "orderedByHighestLatency": [
    TopOperationByNameOrderedByHighestLatency
  ]
}

TopOperationsByNameAndHash

Fields
Field Name Description
orderedByHighestCount - [TopOperationByNameAndHashOrderedByHighestCount!]!
orderedByHighestErrorRatio - [TopOperationByNameAndHashOrderedByHighestErrorRatio!]!
orderedByHighestLatency - [TopOperationByNameAndHashOrderedByHighestLatency!]!
Example
{
  "orderedByHighestCount": [
    TopOperationByNameAndHashOrderedByHighestCount
  ],
  "orderedByHighestErrorRatio": [
    TopOperationByNameAndHashOrderedByHighestErrorRatio
  ],
  "orderedByHighestLatency": [
    TopOperationByNameAndHashOrderedByHighestLatency
  ]
}

Trace

Fields
Field Name Description
id - ID!
rootSpanId - ID!
spans - [TraceSpan!]!
Example
{
  "id": 4,
  "rootSpanId": "4",
  "spans": [TraceSpan]
}

TraceSpan

Fields
Field Name Description
attributes - JSON! Attributes are key-value pairs that represent additional information about the span. It's always a map of strings to strings.
endedAt - DateTime!
id - ID!
name - String!
parentId - ID
startedAt - DateTime!
statusCode - TraceSpanStatusCode
Example
{
  "attributes": {},
  "endedAt": "2007-12-03T10:15:30Z",
  "id": 4,
  "name": "abc123",
  "parentId": "4",
  "startedAt": "2007-12-03T10:15:30Z",
  "statusCode": "ERROR"
}

TraceSpanStatusCode

Values
Enum Value Description

ERROR

OK

Example
"ERROR"

TrialPlanUnavailableError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

TrustedDocument

Fields
Field Name Description
documentId - String!
documentText - String!
Example
{
  "documentId": "xyz789",
  "documentText": "xyz789"
}

TrustedDocumentInput

Fields
Input Field Description
documentId - String!
documentText - String!
Example
{
  "documentId": "abc123",
  "documentText": "abc123"
}

TrustedDocumentsSubmitPayload

Example
GraphDoesNotExistError

TrustedDocumentsSubmitSuccess

Fields
Field Name Description
count - Int!
documents - [TrustedDocument!]!
Example
{"count": 123, "documents": [TrustedDocument]}

Upload

Example
Upload

Url

Description

URL is a String implementing the URL Standard

Example
Url

UsageFilters

Fields
Input Field Description
graphSlug - String
range - Duration Use this if you really care about having a specific duration like 1 hour, 7 days, etc.
from - DateTime Use this if you at least the data between from and to to be provided. You may get more, but never less.
to - DateTime! To be used in conjunction with with either range or from.
isCustomRange - Boolean If explicitly to false, specifying both from and to will be treated as if range: (to - from) had been specified instead. Meaning only the duration between from and to matters, not necessarily having a data point for from itself.
aggregationStep - Duration If specified, overrides approximateNumberOfPoints. Must be in whole minutes. At most 150 points can be returned.
approximateNumberOfDataPoints - Int Defaults to 100, at most 150 points can be returned.
alignPeriodWithAggregationStep - Boolean

Defaults to true Example: for an aggregationStep of 15 min:

  • if true, only times with 00, 15, 30 and 45 minutes will appear in the time series
  • if false, times in the time series will be adjusted to start from the periodStart (~from). So if from = 15:32:00, times will end in 02, 17, 32 and 47. I'll always align to the aggregation step used to store the data though, which is currently in minutes. So cannot have 15:10:20, 15:11:20, etc.
Example
{
  "graphSlug": "abc123",
  "range": "P3Y6M4DT12H30M5S",
  "from": "2007-12-03T10:15:30Z",
  "to": "2007-12-03T10:15:30Z",
  "isCustomRange": true,
  "aggregationStep": "P3Y6M4DT12H30M5S",
  "approximateNumberOfDataPoints": 123,
  "alignPeriodWithAggregationStep": true
}

UsageMetrics

Fields
Field Name Description
requestsCount - Int!
spansCount - Int!
Example
{"requestsCount": 987, "spansCount": 987}

UsageMetricsTimeSeriesDataPoint

Fields
Field Name Description
dateTime - DateTime!
requestsCount - Int!
spansCount - Int!
Example
{
  "dateTime": "2007-12-03T10:15:30Z",
  "requestsCount": 123,
  "spansCount": 987
}

User

Fields
Field Name Description
avatarUrl - String
canStartNewTrial - Boolean!
createdAt - DateTime!
email - String!
id - ID!
name - String!
organizationMemberships - [Member!]!
organizations - OrganizationConnection!
Arguments
after - String
before - String
first - Int
last - Int
Example
{
  "avatarUrl": "xyz789",
  "canStartNewTrial": true,
  "createdAt": "2007-12-03T10:15:30Z",
  "email": "xyz789",
  "id": "4",
  "name": "xyz789",
  "organizationMemberships": [Member],
  "organizations": OrganizationConnection
}

UserAccessTokensCannotBeScopedToAGraphError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

UserConnection

Fields
Field Name Description
edges - [UserEdge!]! A list of edges.
nodes - [User!]! A list of nodes.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int!
Example
{
  "edges": [UserEdge],
  "nodes": [User],
  "pageInfo": PageInfo,
  "totalCount": 987
}

UserDeletePayload

Example
OrganizationOwnershipNotTransferredError

UserDeleteSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

UserDoesNotExistError

Fields
Field Name Description
query - Query!
Example
{"query": Query}

UserEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination
node - User! The item at the end of the edge
role - TeamRole!
Example
{
  "cursor": "xyz789",
  "node": User,
  "role": "MEMBER"
}

UserOrTeam

Types
Union Types

Team

User

Example
Team

UserUpdateInput

Fields
Input Field Description
name - String!
Example
{"name": "xyz789"}

UserUpdatePayload

Example
NameSizeCheckError

UserUpdateSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ValidationCheckError

Fields
Field Name Description
message - String!
title - String!
Example
{
  "message": "xyz789",
  "title": "xyz789"
}

VersionedExtensionManifest

Example
VersionedExtensionManifest

ZitadelAddRedirectFailure

Fields
Field Name Description
error - String
query - Query!
Example
{
  "error": "abc123",
  "query": Query
}

ZitadelAddRedirectPayload

Example
NotEnterprisePlatformError

ZitadelAddRedirectSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ZitadelInitFailure

Fields
Field Name Description
error - String
query - Query!
Example
{
  "error": "xyz789",
  "query": Query
}

ZitadelInitPayload

Example
NotEnterprisePlatformError

ZitadelInitSuccess

Fields
Field Name Description
query - Query!
Example
{"query": Query}

ZitadelStatus

Fields
Field Name Description
clientId - String
idp - Boolean!
organizationId - String
redirect - Boolean!
resources - Boolean!
Example
{
  "clientId": "xyz789",
  "idp": true,
  "organizationId": "xyz789",
  "redirect": false,
  "resources": true
}