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!
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
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
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
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
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
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
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!
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
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
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
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!
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
Response
Arguments
Name | Description |
---|---|
input - SchemaProposalsConfiguredReviewerAddInput!
|
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
Response
Arguments
Name | Description |
---|---|
input - SchemaProposalsConfiguredReviewerRemoveInput!
|
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
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
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!
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
Response
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!
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
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.
Response
Returns a SchemaCheckCustomWebhookCreatePayload
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.
Response
Returns a SchemaCheckCustomWebhookDeletePayload
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.
Response
Returns a SchemaCheckCustomWebhookUpdatePayload
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
Response
Returns a SchemaProposalCommentReplyPayload!
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
Response
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.
Response
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.
Response
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
Response
Returns a SchemaProposalRequestReviewPayload!
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.
Response
Returns a SchemaProposalRevertToDraftPayload!
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.
Response
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!
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!
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!
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!
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!
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!
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
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
Example
AccessTokenCreateSuccess
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
Types
Union Types |
---|
Example
AccessTokenDeleteSuccess
AccessTokenDeleteSuccess
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 |
---|---|
|
|
|
Example
"USER"
Account
Fields
Field Name | Description |
---|---|
accessTokens - AccessTokenConnection!
|
|
createdAt - DateTime!
|
|
graphs - GraphConnection!
|
|
id - ID!
|
|
name - String!
|
|
plan - GrafbasePlan!
|
|
slug - String!
|
|
status - AccountStatus!
|
|
usage - AccountUsageTimeSeries
|
|
Arguments
|
Possible Types
Account Types |
---|
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
Boolean
Example
true
Branch
Fields
Field Name | Description |
---|---|
activeDeployment - Deployment
|
|
analytics - GraphAnalytics
|
|
Arguments
|
|
deployments - DeploymentConnection!
|
|
Arguments |
|
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 |
|
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
BranchCreatePayload
Types
Union Types |
---|
Example
BranchAlreadyExistsError
BranchDeletePayload
Types
Union Types |
---|
Example
BranchDoesNotExistError
BranchDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
BranchEdge
BranchEnvironment
Values
Enum Value | Description |
---|---|
|
|
|
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 |
---|
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
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
DeleteSubgraphInput
DeleteSubgraphPayload
Example
DeleteSubgraphDeploymentFailure
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
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 |
---|---|
|
|
|
|
|
|
|
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 |
---|
Example
DeploymentStepGeneralError
DeploymentStepGeneralError
Fields
Field Name | Description |
---|---|
message - String!
|
Example
{"message": "abc123"}
DeploymentStepStatus
Values
Enum Value | Description |
---|---|
|
|
|
Example
"SUCCESS"
DeploymentSubgraph
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 |
---|---|
|
|
|
Example
"OLD"
DiffSnippet
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
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 |
---|
Example
GraphDoesNotExistError
ErrorCountByCode
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
Types
Union Types |
---|
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 |
---|---|
|
|
|
|
|
|
|
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 |
---|---|
|
|
|
Replaced by AUTHENTICATION |
|
|
|
|
|
|
|
|
|
|
|
Example
"FIELD_RESOLVER"
ExtensionPublishPayload
Example
BadWasmModuleError
ExtensionPublishSuccess
Fields
Field Name | Description |
---|---|
extensionVersion - ExtensionVersion!
|
|
query - Query!
|
Example
{
"extensionVersion": ExtensionVersion,
"query": Query
}
ExtensionRemoveOwnerPayload
Types
Union Types |
---|
Example
ExtensionDoesNotExistError
ExtensionRemoveOwnerSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
ExtensionValidationError
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
Types
Union Types |
---|
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
|
|
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
Float
Example
987.65
GrafbasePlan
Values
Enum Value | Description |
---|---|
|
|
|
|
|
Example
"TRIAL"
Graph
Fields
Field Name | Description |
---|---|
account - Account!
|
|
analytics - GraphAnalytics
|
|
Arguments
|
|
branch - Branch
|
|
Arguments
|
|
branches - BranchConnection!
|
|
createdAt - DateTime!
|
|
customCheckWebhooks - [CustomCheckWebhook!]
|
Webhooks for custom schema checks. |
id - ID!
|
|
operationChecksConfiguration - GraphOperationCheckConfiguration!
|
|
owners - [Team!]!
|
|
productionBranch - Branch!
|
|
request - Request
|
|
requests - RequestConnection
|
|
Arguments |
|
schemaChecks - SchemaCheckConnection!
|
|
schemaProposals - SchemaProposalConnection!
|
|
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
Types
Union Types |
---|
Example
GraphAddOwnerSuccess
GraphAddOwnerSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
GraphAnalytics
Fields
Field Name | Description |
---|---|
forField - FieldAnalytics!
|
|
Arguments
|
|
requestMetrics - RequestMetricsTimeSeriesV2
|
|
Arguments
|
|
topClients - TopClients
|
|
topOperations - TopOperations
|
|
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:
|
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
GraphCreatePayload
Example
AccountDoesNotExistError
GraphCreateSuccess
GraphDeleteInput
Fields
Input Field | Description |
---|---|
id - ID!
|
Example
{"id": 4}
GraphDeletePayload
Types
Union Types |
---|
Example
GraphDeleteSuccess
GraphDeleteSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
GraphDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
GraphEdge
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
Types
Union Types |
---|
Example
GraphDoesNotExistError
GraphRemoveOwnerPayload
Types
Union Types |
---|
Example
GraphDoesNotExistError
GraphRemoveOwnerSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
GraphScopeLimitExceededError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
GraphUpdateInput
GraphUpdatePayload
Example
CannotBeRenamedError
GraphUpdateSuccess
HttpHeader
HttpHeaderInput
ID
Example
"4"
InboxMessage
Possible Types
InboxMessage Types |
---|
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
Example
AlreadyMemberError
InviteAcceptSuccess
InviteCancelInput
Fields
Input Field | Description |
---|---|
id - ID!
|
Example
{"id": "4"}
InviteCancelPayload
Types
Union Types |
---|
Example
InviteCancelSuccess
InviteCancelSuccess
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
Types
Union Types |
---|
Example
InviteDeclineSuccess
InviteDeclineSuccess
InviteDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
InviteEdge
InviteSendInput
Fields
Input Field | Description |
---|---|
role - MemberRole!
|
|
email - String!
|
|
organizationId - ID!
|
Example
{
"role": "OWNER",
"email": "xyz789",
"organizationId": "4"
}
InviteSendPayload
Example
CannotUseInvitationsWithSso
InviteSendSuccess
InviteStatus
Values
Enum Value | Description |
---|---|
|
|
|
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
MemberEdge
MemberRole
Values
Enum Value | Description |
---|---|
|
|
|
|
|
Example
"OWNER"
MemberUpdateInput
Fields
Input Field | Description |
---|---|
id - ID!
|
|
role - MemberRole
|
Example
{"id": "4", "role": "OWNER"}
MemberUpdatePayload
NameSizeCheckError
Node
Fields
Field Name | Description |
---|---|
id - ID!
|
Possible Types
Node Types |
---|
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 |
---|
Example
NotificationsMarkAsReadSuccess
NotificationsMarkAsReadSuccess
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 |
---|---|
|
|
|
|
|
Example
"QUERY"
Organization
Fields
Field Name | Description |
---|---|
accessTokens - AccessTokenConnection!
|
|
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!
|
|
id - ID!
|
|
invites - InviteConnection!
|
|
members - MemberConnection!
|
|
name - String!
|
|
plan - GrafbasePlan!
|
|
samlDomain - String
|
|
slackIntegration - SlackIntegration
|
|
slug - String!
|
|
status - AccountStatus!
|
|
teams - TeamConnection!
|
|
trialExpiresAt - DateTime
|
|
usage - AccountUsageTimeSeries
|
|
Arguments
|
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
OrganizationCreatePayload
Example
NameSizeCheckError
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
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
OrganizationSlugUpdatePayload
Example
NotAllowedToSlugUpdateError
OrganizationSlugUpdateSuccess
Fields
Field Name | Description |
---|---|
organization - Organization!
|
|
query - Query!
|
Example
{
"organization": Organization,
"query": Query
}
OrganizationUpdateInput
OrganizationUpdatePayload
Example
NameSizeCheckError
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
Types
Union Types |
---|
Example
NameSizeCheckError
PersonalAccountUpdateSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
ProposalCheckError
PublishDeploymentFailure
PublishForbidden
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
PublishInput
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
Example
FederatedGraphCompositionError
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
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
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
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
ReusedId
Description
An occurrence of a trusted document that was submitted again (same id), but with a different document text. This is an error.
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 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
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
Types
Union Types |
---|
Example
SchemaCheckCustomWebhookCreateSuccess
SchemaCheckCustomWebhookCreateSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaCheckCustomWebhookDeletePayload
Types
Union Types |
---|
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
Types
Union Types |
---|
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 |
---|---|
|
|
|
Example
"ERROR"
SchemaCheckGitCommit
Example
{
"authorAvatarUrl": "xyz789",
"authorName": "xyz789",
"branch": "xyz789",
"commitSha": "abc123",
"commitUrl": "xyz789",
"message": "abc123"
}
SchemaCheckGitCommitInput
Example
{
"message": "xyz789",
"branch": "xyz789",
"commitSha": "xyz789",
"commitUrl": "abc123",
"authorName": "xyz789",
"authorAvatarUrl": "xyz789"
}
SchemaCheckPayload
Example
GraphBranchDoesNotExistError
SchemaCheckStep
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
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:
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
|
|
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
Fields
Field Name | Description |
---|---|
createdAt - DateTime!
|
Possible Types
SchemaProposalActivityFeedItem Types |
---|
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
SchemaProposalApprovePayload
Types
Union Types |
---|
Example
SchemaProposalApproveSuccess
SchemaProposalApproveSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaProposalComment
Possible Types
SchemaProposalComment Types |
---|
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
|
|
createdAt - DateTime!
|
|
diffSide - DiffSide!
|
|
id - ID!
|
|
line - Int
|
Which line the comment applies to in the subgraph SDL. This may be 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
Example
{
"author": User,
"createdAt": "2007-12-03T10:15:30Z",
"id": 4,
"replies": [SchemaProposalReply],
"resolved": false,
"resolvedBy": User,
"text": "xyz789"
}
SchemaProposalCommentReplyPayload
Types
Union Types |
---|
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
Types
Union Types |
---|
Example
SchemaProposalCommentThreadCreateSuccess
SchemaProposalCommentThreadCreateSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaProposalCommentThreadLocation
Values
Enum Value | Description |
---|---|
|
|
|
|
|
Example
"PROPOSAL"
SchemaProposalCommentThreadResolvePayload
Types
Union Types |
---|
Example
SchemaProposalCommentThreadResolveSuccess
SchemaProposalCommentThreadResolveSuccess
SchemaProposalCommentThreadUnresolvePayload
Types
Union Types |
---|
Example
SchemaProposalCommentThreadUnresolveSuccess
SchemaProposalCommentThreadUnresolveSuccess
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
SchemaProposalCreatePayload
Types
Union Types |
---|
Example
SchemaProposalCreateSuccess
SchemaProposalCreateSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
|
schemaProposal - SchemaProposal!
|
Example
{
"query": Query,
"schemaProposal": SchemaProposal
}
SchemaProposalDeletePayload
Types
Union Types |
---|
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
SchemaProposalEditParserErrors
Fields
Field Name | Description |
---|---|
errors - [SchemaProposalEditParserError!]!
|
Example
{"errors": [SchemaProposalEditParserError]}
SchemaProposalEditPayload
Example
SchemaProposalDoesNotExistError
SchemaProposalEditSubgraph
SchemaProposalEditSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaProposalFilter
Fields
Input Field | Description |
---|---|
status - SchemaProposalStatus
|
Example
{"status": "APPROVED"}
SchemaProposalRejectInput
SchemaProposalRejectPayload
Types
Union Types |
---|
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
SchemaProposalRequestReviewInput
Fields
Input Field | Description |
---|---|
id - ID!
|
Example
{"id": 4}
SchemaProposalRequestReviewPayload
Types
Union Types |
---|
Example
SchemaProposalDoesNotExistError
SchemaProposalRequestReviewSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaProposalRevertToDraftPayload
Types
Union Types |
---|
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 |
---|
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
SchemaProposalReviewRequestCreatePayload
Types
Union Types |
---|
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
Types
Union Types |
---|
Example
SchemaProposalReviewerTeam
SchemaProposalReviewerStatus
Values
Enum Value | Description |
---|---|
|
|
|
|
|
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
SchemaProposalStatus
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
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
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 |
---|---|
|
|
|
|
|
|
|
Example
"CREATED"
SchemaProposalUpdateInput
SchemaProposalUpdatePayload
Types
Union Types |
---|
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
SchemaProposalsConfiguredReviewerAddInput
SchemaProposalsConfiguredReviewerAddPayload
Example
AlreadyExistsError
SchemaProposalsConfiguredReviewerAddSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
|
reviewer - SchemaProposalsConfiguredReviewers!
|
Example
{
"query": Query,
"reviewer": SchemaProposalsConfiguredReviewerTeam
}
SchemaProposalsConfiguredReviewerRemoveInput
SchemaProposalsConfiguredReviewerRemovePayload
Example
BranchDoesNotExistError
SchemaProposalsConfiguredReviewerRemoveSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaProposalsConfiguredReviewerTeam
SchemaProposalsConfiguredReviewerUser
SchemaProposalsConfiguredReviewers
Description
A (required) schema proposal reviewer in the branch configuration.
Types
Union Types |
---|
Example
SchemaProposalsConfiguredReviewerTeam
SchemaRegistryBranchDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SchemaVersion
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
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
SlackIntegration
Fields
Field Name | Description |
---|---|
availableChannels - [SlackChannel!]!
|
|
notifications - [SlackNotification!]!
|
Example
{
"availableChannels": [SlackChannel],
"notifications": [SlackNotification]
}
SlackIntegrationCreateInput
SlackNotification
SlackNotificationCreatePayload
Types
Union Types |
---|
Example
GraphDoesNotExistError
SlackNotificationDeletePayload
Types
Union Types |
---|
Example
Query
SlugAlreadyExistsError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SlugError
SlugInvalidError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
SlugSizeCheckError
SlugTooLongError
StandaloneGraphsNoLongerSupportedError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
String
Example
"xyz789"
Subgraph
SubgraphAddOwnerPayload
Types
Union Types |
---|
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 |
---|
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 |
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 |
Example
{
"id": "4",
"members": UserConnection,
"name": "xyz789",
"parent": Team,
"parentTeamId": "4",
"query": Query,
"slug": "xyz789",
"subteams": TeamConnection
}
TeamAddMemberPayload
Types
Union Types |
---|
Example
TeamAddMemberSuccess
TeamAddMemberSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TeamAssignRolePayload
Types
Union Types |
---|
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
Types
Union Types |
---|
Example
OrganizationDoesNotExistError
TeamDeletePayload
Types
Union Types |
---|
Example
TeamDeleteSuccess
TeamDeleteSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TeamDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TeamEdge
TeamNameAlreadyTakenError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TeamRemoveMemberPayload
Types
Union Types |
---|
Example
TeamDoesNotExistError
TeamRemoveMemberSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TeamRole
Values
Enum Value | Description |
---|---|
|
|
|
Example
"MEMBER"
TokenDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TokenLimitExceededError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
TopClientByNameAndVersionOrderedByHighestCount
TopClientByNameAndVersionOrderedByHighestErrorRatio
TopClientByNameAndVersionOrderedByHighestLatency
TopClientByNameOrderedByHighestCount
TopClientByNameOrderedByHighestErrorRatio
TopClientByNameOrderedByHighestLatency
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
TopOperationByNameOrderedByHighestErrorRatio
TopOperationByNameOrderedByHighestLatency
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
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 |
---|---|
|
|
|
Example
"ERROR"
TrustedDocument
TrustedDocumentInput
TrustedDocumentsSubmitPayload
Types
Union Types |
---|
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:
|
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
UsageMetricsTimeSeriesDataPoint
User
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
Types
Union Types |
---|
Example
OrganizationOwnershipNotTransferredError
UserDeleteSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
UserDoesNotExistError
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
UserEdge
UserOrTeam
UserUpdateInput
Fields
Input Field | Description |
---|---|
name - String!
|
Example
{"name": "xyz789"}
UserUpdatePayload
Types
Union Types |
---|
Example
NameSizeCheckError
UserUpdateSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
ValidationCheckError
VersionedExtensionManifest
Example
VersionedExtensionManifest
ZitadelAddRedirectFailure
ZitadelAddRedirectPayload
Types
Union Types |
---|
Example
NotEnterprisePlatformError
ZitadelAddRedirectSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}
ZitadelInitFailure
ZitadelInitPayload
Types
Union Types |
---|
Example
NotEnterprisePlatformError
ZitadelInitSuccess
Fields
Field Name | Description |
---|---|
query - Query!
|
Example
{"query": Query}