schema {
query: RootQuery
mutation: RootMutation
}
type AcceptUserInvitationResult {
success: Boolean!
}
"""A method of authentication for an Actor"""
type AccessToken {
createdAt: DateTime!
id: ID!
lastUsedAt: DateTime
note: String
owner: Actor!
revokedAt: DateTime
"""
Scopes this token is restricted to. Null for a full token that authenticates as the owner
with all of their permissions.
"""
scopes: [AccessTokenScope!]
updatedAt: DateTime!
visibleTokenPrefix: String!
}
type AccessTokenMutation {
"""Create an AccessToken for an Actor"""
createAccessToken(createAccessTokenData: CreateAccessTokenInput!): CreateAccessTokenResponse!
"""Delete an AccessToken"""
deleteAccessToken(id: ID!): DeleteAccessTokenResult!
"""Revoke an AccessToken"""
setAccessTokenRevoked(id: ID!, revoked: Boolean): AccessToken!
}
"""One scope narrowing an AccessToken below its owner's full access"""
type AccessTokenScope {
"""The account this scope applies to. Only present for ACCOUNT scopes."""
accountID: ID
permissions: [Permission!]!
type: AccessTokenScopeType!
}
input AccessTokenScopeInput {
"""
The account this scope applies to. Required for ACCOUNT scopes and must be omitted for
ALL_ACCOUNTS scopes.
"""
accountID: ID
permissions: [Permission!]!
type: AccessTokenScopeType!
}
enum AccessTokenScopeType {
"""One account, named by accountID, narrowed to the scope's permissions."""
ACCOUNT
"""
Every account the token's owner has permissions on at request time, narrowed to the
scope's permissions.
"""
ALL_ACCOUNTS
}
"""
A GitHub App installation visible to a viewer, not necessarily linked yet.
"""
type AccessibleGitHubAppInstallation {
account: AccessibleGitHubAppInstallationAccount!
installationIdentifier: Int!
}
type AccessibleGitHubAppInstallationAccount {
avatarUrl: String!
login: String!
type: GitHubAppInstallationAccountType!
}
type AccessibleGitHubRepository {
id: Int!
name: String!
nodeId: String!
owner: AccessibleGitHubRepositoryOwner!
private: Boolean!
}
type AccessibleGitHubRepositoryOwner {
login: String!
}
"""
An account is a container owning projects, credentials, billing and other organization
data and settings. Actors may own and be members of accounts.
"""
type Account {
"""
Server account feature gate values for this account, optionally filtering by desired gates.
"""
accountFeatureGates(filter: [String!]): JSONObject!
"""Coalesced project activity for all apps belonging to this account."""
activityTimelineProjectActivities(
""" Offset the query """
createdBefore: DateTime
""" Types of objects to filter """
filterTypes: [ActivityTimelineProjectActivityType!]
limit: Int!
): [ActivityTimelineProjectActivity!]!
"""AI provider connections available to agent sandbox sessions."""
agentProviderConnections: [AgentProviderConnection!]!
appCount: Int!
appStoreConnectApiKeys: [AppStoreConnectApiKey!]! @deprecated(reason: "Use appStoreConnectApiKeysPaginated")
appStoreConnectApiKeysPaginated(after: String, before: String, first: Int, last: Int): AccountAppStoreConnectApiKeysConnection!
appleAppIdentifiers(bundleIdentifier: String): [AppleAppIdentifier!]!
appleDevicesPaginated(after: String, before: String, filter: AppleDeviceFilterInput, first: Int, last: Int): AccountAppleDevicesConnection!
appleDistributionCertificates: [AppleDistributionCertificate!]! @deprecated(reason: "Use appleDistributionCertificatesPaginated")
appleDistributionCertificatesPaginated(after: String, before: String, first: Int, last: Int): AccountAppleDistributionCertificatesConnection!
appleProvisioningProfiles(appleAppIdentifierId: ID): [AppleProvisioningProfile!]! @deprecated(reason: "Use appleProvisioningProfilesPaginated")
appleProvisioningProfilesPaginated(after: String, before: String, first: Int, last: Int): AccountAppleProvisioningProfilesConnection!
applePushKeys: [ApplePushKey!]! @deprecated(reason: "Use applePushKeysPaginated")
applePushKeysPaginated(after: String, before: String, first: Int, last: Int): AccountApplePushKeysConnection!
appleTeams(appleTeamIdentifier: String, limit: Int, offset: Int): [AppleTeam!]! @deprecated(reason: "Use appleTeamsPaginated")
"""iOS credentials for account"""
appleTeamsPaginated(after: String, before: String, filter: AppleTeamFilterInput, first: Int, last: Int): AccountAppleTeamsConnection!
"""Apps associated with this account"""
apps(includeUnpublished: Boolean, limit: Int!, offset: Int!): [App!]! @deprecated(reason: "Use appsPaginated")
"""
Paginated list of apps associated with this account. By default sorted by name. Use filter to adjust the sorting order.
"""
appsPaginated(after: String, before: String, filter: AccountAppsFilterInput, first: Int, last: Int): AccountAppsConnection!
"""Audit logs for account"""
auditLogsPaginated(after: String, before: String, filter: AuditLogFilterInput, first: Int, last: Int): AuditLogConnection!
"""
Billing information. Only visible to members with the ADMIN or OWNER role.
"""
billing: Billing
billingPeriod(date: DateTime!): BillingPeriod!
concurrencyConsumers(limit: Int! = 500): [ConcurrencyConsumer!]!
"""Convex team connections for this account"""
convexTeamConnections: [ConvexTeamConnection!]!
createdAt: DateTime!
"""
Simulator sessions for all apps associated with this account, sorted newest first.
"""
deviceRunSessionsPaginated(after: String, before: String, filter: AccountDeviceRunSessionFilterInput, first: Int, last: Int): AccountDeviceRunSessionsConnection!
displayName: String
"""Environment secrets for an account"""
environmentSecrets(filterNames: [String!]): [EnvironmentSecret!]!
environmentVariableEnvironments: [EnvironmentVariableEnvironment!]!
"""
Whether the account turned on environment variable protection. When protection is on, using,
creating, changing, or deleting a SECRET environment variable needs the PUBLISH_PROTECTED
permission, in every project of the account. Expo can also turn protection on for an
account; this field does not show that.
"""
environmentVariableProtectionEnabled: Boolean!
"""Environment variables for an account"""
environmentVariables(environment: EnvironmentVariableEnvironment, filterNames: [String!]): [EnvironmentVariable!]!
"""Environment variables for an account with decrypted secret values"""
environmentVariablesIncludingSensitive(environment: EnvironmentVariableEnvironment, filterNames: [String!]): [EnvironmentVariableWithSecret!]!
"""GitHub App installations for an account"""
githubAppInstallations: [GitHubAppInstallation!]!
"""GitHub Enterprise app registration for an account"""
githubAppRegistration: GitHubAppRegistration
googleServiceAccountKeys: [GoogleServiceAccountKey!]! @deprecated(reason: "Use googleServiceAccountKeysPaginated")
"""Android credentials for account"""
googleServiceAccountKeysPaginated(after: String, before: String, first: Int, last: Int): AccountGoogleServiceAccountKeysConnection!
id: ID!
isCurrent: Boolean!
isDisabled: Boolean!
"""
Whether an Account plan falls into AppDevDomainName's free or paid tier
"""
isFreeAppDevDomainTier: Boolean!
"""Whether this account has SSO enabled. Can be queried by all members."""
isSSOEnabled: Boolean!
lastDeletionAttemptTime: DateTime
logRocketOrganization: LogRocketOrganization
"""Aggregate statistics about account members."""
memberStats: AccountMemberStats!
"""
Paginated list of members (actors) associated with this account and their permissions
"""
membersPaginated(
after: String
before: String
filter: AccountMembersFilterInput
first: Int
last: Int
"""Filter members by type. Defaults to ALL."""
memberType: AccountMemberType
): AccountMembersConnection!
name: String!
"""
Whether EAS Observe ingestion is paused for this account. Accounts that have not configured
the setting are treated as false (ingestion enabled).
"""
observeIngestionPaused: Boolean!
"""Offers set on this account"""
offers: [Offer!]
"""Onboarding milestone stats for this account"""
onboardingStats: AccountOnboardingStats!
"""Owning User of this account if personal account"""
owner: User @deprecated(reason: "Deprecated in favor of ownerUserActor")
"""Owning UserActor of this account if personal account"""
ownerUserActor: UserActor
pendingSentryInstallation: PendingSentryInstallation
"""PostHog organization connection for this account"""
posthogOrganizationConnection: PostHogOrganizationConnection
profileImageUrl: String!
pushSecurityEnabled: Boolean!
requireTwoFactor: Boolean!
sentryInstallation: SentryInstallation
"""Snacks associated with this account"""
snacks(limit: Int!, offset: Int!): [Snack!]! @deprecated(reason: "Use snacksPaginated")
"""
Paginated list of Snacks associated with this account, sorted by most recent activity.
"""
snacksPaginated(after: String, before: String, first: Int, last: Int): AccountSnacksConnection!
"""Allowed SSO providers for this account"""
ssoAllowedAuthProviders: [AuthProviderIdentifier!]!
"""SSO configuration for this account"""
ssoConfiguration: AccountSSOConfiguration
"""Subscription info visible to members that have VIEWER role"""
subscription: SubscriptionDetails
"""Supabase connection for this account"""
supabaseConnection: SupabaseConnection
"""Coalesced project activity for an app using pagination"""
timelineActivity(after: String, before: String, filter: TimelineActivityFilterInput, first: Int, last: Int): TimelineActivityConnection!
updatedAt: DateTime!
"""Account query object for querying EAS usage metrics"""
usageMetrics: AccountUsageMetrics!
"""Pending user invitations for this account"""
userInvitations: [UserInvitation!]!
userSpecifiedAccountUsage: UserSpecifiedAccountUsage
"""Actors associated with this account and permissions they hold"""
users: [UserPermission!]! @deprecated(reason: "Deprecated in favor of membersPaginated and memberStats")
"""Vexo account connection for this account"""
vexoAccountConnection: VexoAccountConnection
"""Notification preferences of the viewer for this account"""
viewerNotificationPreferences: [NotificationPreferenceItem!]!
"""Permission info for the viewer on this account"""
viewerUserPermission: UserPermission! @deprecated(reason: "Use viewerUserPermission2 instead")
"""
Permission info for the viewer on this account, including their effective permissions
"""
viewerUserPermission2: ViewerUserPermission!
}
type AccountAppStoreConnectApiKeysConnection {
edges: [AccountAppStoreConnectApiKeysEdge!]!
pageInfo: PageInfo!
}
type AccountAppStoreConnectApiKeysEdge {
cursor: String!
node: AppStoreConnectApiKey!
}
type AccountAppleDevicesConnection {
edges: [AccountAppleDevicesEdge!]!
pageInfo: PageInfo!
}
type AccountAppleDevicesEdge {
cursor: String!
node: AppleDevice!
}
type AccountAppleDistributionCertificatesConnection {
edges: [AccountAppleDistributionCertificatesEdge!]!
pageInfo: PageInfo!
}
type AccountAppleDistributionCertificatesEdge {
cursor: String!
node: AppleDistributionCertificate!
}
type AccountAppleProvisioningProfilesConnection {
edges: [AccountAppleProvisioningProfilesEdge!]!
pageInfo: PageInfo!
}
type AccountAppleProvisioningProfilesEdge {
cursor: String!
node: AppleProvisioningProfile!
}
type AccountApplePushKeysConnection {
edges: [AccountApplePushKeysEdge!]!
pageInfo: PageInfo!
}
type AccountApplePushKeysEdge {
cursor: String!
node: ApplePushKey!
}
type AccountAppleTeamsConnection {
edges: [AccountAppleTeamsEdge!]!
pageInfo: PageInfo!
}
type AccountAppleTeamsEdge {
cursor: String!
node: AppleTeam!
}
type AccountAppsConnection {
edges: [AccountAppsEdge!]!
pageInfo: PageInfo!
}
type AccountAppsEdge {
cursor: String!
node: App!
}
input AccountAppsFilterInput {
searchTerm: String
sortByField: AccountAppsSortByField!
}
enum AccountAppsSortByField {
LATEST_ACTIVITY_TIME
"""
Name prefers the display name but falls back to full_name with @account/
part stripped.
"""
NAME
}
input AccountDataInput {
displayName: String
name: String!
userSpecifiedAccountUsage: UserSpecifiedAccountUsage
}
input AccountDeviceRunSessionFilterInput {
statuses: [DeviceRunSessionStatus!]
}
type AccountDeviceRunSessionsConnection {
edges: [AccountDeviceRunSessionsEdge!]!
pageInfo: PageInfo!
}
type AccountDeviceRunSessionsEdge {
cursor: String!
node: DeviceRunSession!
}
type AccountGoogleServiceAccountKeysConnection {
edges: [AccountGoogleServiceAccountKeysEdge!]!
pageInfo: PageInfo!
}
type AccountGoogleServiceAccountKeysEdge {
cursor: String!
node: GoogleServiceAccountKey!
}
"""Aggregate statistics about account members"""
type AccountMemberStats {
"""
Whether all human members (Users only, not SSO) have 2FA enabled.
Also checks the implicit account owner for personal accounts.
"""
allHave2FAEnabled: Boolean!
"""Count of human members (Users + SSOUsers)"""
humanCount: Int!
"""Count of members with OWN permission"""
ownerCount: Int!
"""Count of robot members"""
robotCount: Int!
"""Count of SSO users only"""
ssoUserCount: Int!
"""Total count of all members"""
totalCount: Int!
}
"""Filter for account member types in membersPaginated query"""
enum AccountMemberType {
"""All members (default)"""
ALL
"""Human members (Users + SSOUsers)"""
HUMAN
"""Robot members only"""
ROBOT
"""SSO users only"""
SSO_USER
}
type AccountMembersConnection {
edges: [AccountMembersEdge!]!
pageInfo: PageInfo!
}
type AccountMembersEdge {
cursor: String!
node: UserPermission!
}
input AccountMembersFilterInput {
"""Filter by members containing all of the specified permissions."""
exactPermissions: [Permission!]
"""
Filter members by 2FA status. Only regular users are returned when set, since SSO users
and robots don't have 2FA. Requires admin permission on the account.
"""
isSecondFactorAuthenticationEnabled: Boolean
"""Case-insensitive substring match on username, email, and name"""
searchTerm: String
}
type AccountMutation {
"""Cancels all subscriptions immediately"""
cancelAllSubscriptionsImmediately(accountID: ID!): Account!
"""Cancel scheduled subscription change"""
cancelScheduledSubscriptionChange(accountID: ID!): Account!
"""
Buys or revokes account's additional concurrencies, charging the account the appropriate amount if needed.
"""
changeAdditionalConcurrenciesCount(accountID: ID!, newAdditionalConcurrenciesCount: Int!): Account!
"""
Upgrades or downgrades the active subscription to the newPlanIdentifier, which must be one of the EAS plans (i.e., Production or Enterprise).
"""
changePlan(accountID: ID!, couponCode: String, newPlanIdentifier: String!): Account!
"""
Add specified account Permissions for Actor. Actor must already have at least one permission on the account.
"""
grantActorPermissions(accountID: ID!, actorID: ID!, permissions: [Permission]): Account!
"""
Remove profile image for the account. Do nothing if there's no profile image associated.
"""
removeProfileImage(accountID: ID!): Account!
"""
Rename this account and the primary user's username if this account is a personal account
"""
rename(accountID: ID!, newName: String!): Account!
"""
Requests a refund for the specified charge by requesting a manual refund from support
"""
requestRefund(accountID: ID!, chargeID: ID!, description: String, reason: String): Boolean
"""
Revoke specified Permissions for Actor. Actor must already have at least one permission on the account.
"""
revokeActorPermissions(accountID: ID!, actorID: ID!, permissions: [Permission]): Account!
"""
Set the display name for the account. Pass null to clear it and fall back to the account identifier.
"""
setDisplayName(accountID: ID!, displayName: String): Account!
"""
Set whether environment variable protection is on for this account. When it is on, using,
creating, changing, or deleting a SECRET environment variable needs the PUBLISH_PROTECTED
permission on the account, in every project of the account. Requires the ADMIN permission on
the account. Turning protection off also requires a sudo session.
"""
setEnvironmentVariableProtectionEnabled(accountID: ID!, environmentVariableProtectionEnabled: Boolean!): Account!
"""Set whether EAS Observe ingestion is paused for this account."""
setObserveIngestionPaused(accountID: ID!, paused: Boolean!): Account!
"""
Require authorization to send push notifications for experiences owned by this account
"""
setPushSecurityEnabled(accountID: ID!, pushSecurityEnabled: Boolean!): Account!
"""
Set whether two-factor authentication is required for this account. When enabled:
- Existing members with 2FA cannot disable it
- New members must enable 2FA before joining
- Existing members without 2FA are not affected
"""
setRequireTwoFactor(accountID: ID!, requireTwoFactor: Boolean!): Account!
"""Set the user specified account usage for the account."""
setUserSpecifiedAccountUsage(accountID: ID!, userSpecifiedAccountUsage: UserSpecifiedAccountUsage!): Account!
}
"""Account-level notification preference"""
type AccountNotificationPreference implements NotificationPreference {
account: Account!
enabled: Boolean!
event: NotificationEvent!
type: NotificationType!
}
input AccountNotificationPreferenceInput {
accountId: ID!
enabled: Boolean!
event: NotificationEvent!
type: NotificationType!
}
"""Onboarding milestone stats for an account"""
type AccountOnboardingStats {
firstBuildCompletedAt: DateTime
firstProjectCreatedAt: DateTime
firstSubmissionCompletedAt: DateTime
firstUpdateCreatedAt: DateTime
hasConfiguredUpdate: Boolean! @deprecated(reason: "Onboarding widget experiment removed")
hasConfiguredWorkflow: Boolean!
hasTeamMembers: Boolean! @deprecated(reason: "Onboarding widget experiment removed")
}
type AccountQuery {
"""Query an Account by ID"""
byId(
"""Account id to use to look up account"""
accountId: String!
): Account!
"""Query an Account by name"""
byName(
"""Account name to use to look up account"""
accountName: String!
): Account!
}
"""Auth configuration data for an SSO account."""
type AccountSSOConfiguration {
authProtocol: AuthProtocolType!
authProviderIdentifier: AuthProviderIdentifier!
clientIdentifier: String!
clientSecret: String!
createdAt: DateTime!
id: ID!
issuer: String!
updatedAt: DateTime!
}
input AccountSSOConfigurationData {
authProtocol: AuthProtocolType!
authProviderIdentifier: AuthProviderIdentifier!
clientIdentifier: String!
clientSecret: String!
issuer: String!
}
type AccountSSOConfigurationMutation {
"""Create an AccountSSOConfiguration for an Account"""
createAccountSSOConfiguration(accountId: ID!, accountSSOConfigurationData: AccountSSOConfigurationData!): AccountSSOConfiguration!
"""Delete an AccountSSOConfiguration"""
deleteAccountSSOConfiguration(id: ID!): DeleteAccountSSOConfigurationResult!
"""Update an AccountSSOConfiguration"""
updateAccountSSOConfiguration(accountSSOConfigurationData: AccountSSOConfigurationData!, id: ID!): AccountSSOConfiguration!
"""Update just the client secret of an AccountSSOConfiguration"""
updateAccountSSOConfigurationClientSecret(clientSecret: String!, id: ID!): AccountSSOConfiguration!
}
"""Public auth configuration data for an SSO account."""
type AccountSSOConfigurationPublicData {
authProtocol: AuthProtocolType!
authProviderIdentifier: AuthProviderIdentifier!
authorizationUrl: String!
id: ID!
issuer: String!
}
type AccountSSOConfigurationPublicDataQuery {
"""Get AccountSSOConfiguration public data by account name"""
publicDataByAccountName(
"""Account name to use to look up account SSO configuration"""
accountName: String!
): AccountSSOConfigurationPublicData!
}
type AccountSnacksConnection {
edges: [AccountSnacksEdge!]!
pageInfo: PageInfo!
}
type AccountSnacksEdge {
cursor: String!
node: Snack!
}
enum AccountUploadSessionType {
PROFILE_IMAGE_UPLOAD
WORKFLOWS_PROJECT_SOURCES
}
type AccountUsageEASBuildMetadata {
billingResourceClass: EASBuildBillingResourceClass
platform: AppPlatform
waiverType: EASBuildWaiverType
}
union AccountUsageMetadata = AccountUsageEASBuildMetadata
type AccountUsageMetric {
id: ID!
metricType: UsageMetricType!
serviceMetric: EASServiceMetric!
timestamp: DateTime!
value: Float!
}
type AccountUsageMetrics {
byBillingPeriod(date: DateTime!, service: EASService): UsageMetricTotal!
metricsForServiceMetric(filterParams: JSONObject, granularity: UsageMetricsGranularity!, serviceMetric: EASServiceMetric!, timespan: UsageMetricsTimespan!): [AccountUsageMetric!]!
}
interface ActivityTimelineProjectActivity {
activityTimestamp: DateTime!
actor: Actor
id: ID!
}
enum ActivityTimelineProjectActivityType {
BUILD
SUBMISSION
UPDATE
WORKER
WORKFLOW_RUN
}
"""
A regular user, SSO user, or robot that can authenticate with Expo services and be a member of accounts.
"""
interface Actor {
"""Access Tokens belonging to this actor"""
accessTokens: [AccessToken!]!
"""Associated accounts"""
accounts: [Account!]!
created: DateTime!
"""
Best-effort human readable name for this actor for use in user interfaces during action attribution.
For example, when displaying a sentence indicating that actor X created a build or published an update.
"""
displayName: String!
"""Experiments associated with this actor"""
experiments: [ActorExperiment!]!
"""
Server feature gate values for this actor, optionally filtering by desired gates.
Only resolves for the viewer.
"""
featureGates(filter: [String!]): JSONObject!
firstName: String
id: ID!
isExpoAdmin: Boolean!
lastDeletionAttemptTime: DateTime
}
type ActorExperiment {
createdAt: DateTime!
enabled: Boolean!
experiment: Experiment!
id: ID!
updatedAt: DateTime!
}
type ActorExperimentMutation {
"""Create or update the value of a User Experiment"""
createOrUpdateActorExperiment(enabled: Boolean!, experiment: Experiment!): ActorExperiment!
}
type AddonDetails {
id: ID!
name: String!
nextInvoice: DateTime
planId: String!
quantity: Int
willCancel: Boolean
}
type AgentDeviceRunSessionRemoteConfig {
agentDeviceRemoteSessionToken: String!
agentDeviceRemoteSessionUrl: String!
"""
Fingerprint of the reverse-tunnel server key for the client to pin. Null when
the session does not use local egress.
"""
egressFingerprint: String
"""
Loopback port on the device host that the local egress client must serve
through the tunnel. Null when the session does not use local egress.
"""
egressPort: Int
"""
Secret the local egress client presents to the reverse-tunnel endpoint. Null
when the session does not use local egress.
"""
egressToken: String
"""
Reverse-tunnel endpoint the local egress client connects to. Null when the
session does not use local egress.
"""
egressUrl: String
"""URL of the preview server, for reaching its API rather than its page."""
previewApiUrl: String
"""
Session token gating the web preview. Null when the preview runs ungated.
"""
webPreviewToken: String
"""
URL of the web preview surface for the session. Null when a web preview is
not available for the session.
"""
webPreviewUrl: String
}
enum AgentProvider {
ANTHROPIC
OPENAI
}
type AgentProviderConnection {
account: Account!
createdAt: DateTime!
createdByActor: Actor
expiresAt: DateTime
id: ID!
name: String
provider: AgentProvider!
providerAccountEmail: String
providerAccountId: String
providerPlan: String
status: AgentProviderConnectionStatus!
updatedAt: DateTime!
}
enum AgentProviderConnectionAuthorizationStatus {
EXPIRED
PENDING
SUCCEEDED
}
type AgentProviderConnectionMutation {
completeClaudeConnection(input: CompleteClaudeConnectionInput!): AgentProviderConnection!
deleteAgentProviderConnection(id: ID!): AgentProviderConnection!
pollCodexConnection(requestId: ID!): CodexConnectionPollResult!
startClaudeConnection(input: StartClaudeConnectionInput!): ClaudeAuthorization!
startCodexConnection(accountId: ID!): CodexDeviceAuthorization!
updateAgentProviderConnection(id: ID!, input: UpdateAgentProviderConnectionInput!): AgentProviderConnection!
}
enum AgentProviderConnectionStatus {
INVALID
UNABLE_TO_VERIFY
VALID
}
type AndroidAppBuildCredentials {
androidKeystore: AndroidKeystore
id: ID!
isDefault: Boolean!
isLegacy: Boolean!
name: String!
}
"""
@isDefault: if set, these build credentials will become the default for the Android app. All other build credentials will have their default status set to false.
"""
input AndroidAppBuildCredentialsInput {
isDefault: Boolean!
keystoreId: ID!
name: String!
}
type AndroidAppBuildCredentialsMutation {
"""Create a set of build credentials for an Android app"""
createAndroidAppBuildCredentials(androidAppBuildCredentialsInput: AndroidAppBuildCredentialsInput!, androidAppCredentialsId: ID!): AndroidAppBuildCredentials!
"""delete a set of build credentials for an Android app"""
deleteAndroidAppBuildCredentials(id: ID!): deleteAndroidAppBuildCredentialsResult!
"""Set the build credentials to be the default for the Android app"""
setDefault(id: ID!, isDefault: Boolean!): AndroidAppBuildCredentials!
"""Set the keystore to be used for an Android app"""
setKeystore(id: ID!, keystoreId: ID!): AndroidAppBuildCredentials!
"""
Set the name of a set of build credentials to be used for an Android app
"""
setName(id: ID!, name: String!): AndroidAppBuildCredentials!
}
type AndroidAppCredentials {
androidAppBuildCredentialsArray: [AndroidAppBuildCredentials!]! @deprecated(reason: "use androidAppBuildCredentialsList instead")
androidAppBuildCredentialsList: [AndroidAppBuildCredentials!]!
androidFcm: AndroidFcm
app: App!
applicationIdentifier: String
googleServiceAccountKeyForFcmV1: GoogleServiceAccountKey
googleServiceAccountKeyForSubmissions: GoogleServiceAccountKey
id: ID!
isLegacy: Boolean!
}
input AndroidAppCredentialsFilter {
applicationIdentifier: String
legacyOnly: Boolean
}
input AndroidAppCredentialsInput {
fcmId: ID
googleServiceAccountKeyForFcmV1Id: ID
googleServiceAccountKeyForSubmissionsId: ID
}
type AndroidAppCredentialsMutation {
"""Create a set of credentials for an Android app"""
createAndroidAppCredentials(androidAppCredentialsInput: AndroidAppCredentialsInput!, appId: ID!, applicationIdentifier: String!): AndroidAppCredentials!
"""
Create a GoogleServiceAccountKeyEntity to store credential and
connect it with an edge from AndroidAppCredential
"""
createFcmV1Credential(androidAppCredentialsId: String!, credential: String!): AndroidAppCredentials!
"""Delete a set of credentials for an Android app"""
deleteAndroidAppCredentials(id: ID!): DeleteAndroidAppCredentialsResult!
"""Set the FCM push key to be used in an Android app"""
setFcm(fcmId: ID!, id: ID!): AndroidAppCredentials!
"""
Set the Google Service Account Key to be used for Firebase Cloud Messaging V1
"""
setGoogleServiceAccountKeyForFcmV1(googleServiceAccountKeyId: ID!, id: ID!): AndroidAppCredentials!
"""
Set the Google Service Account Key to be used for submitting an Android app
"""
setGoogleServiceAccountKeyForSubmissions(googleServiceAccountKeyId: ID!, id: ID!): AndroidAppCredentials!
}
enum AndroidBuildType {
APK
APP_BUNDLE
"""@deprecated Use developmentClient option instead."""
DEVELOPMENT_CLIENT
}
input AndroidBuilderEnvironmentInput {
bun: String
corepack: Boolean
env: JSONObject
expoCli: String
image: String
ndk: String
node: String
pnpm: String
yarn: String
}
type AndroidDeviceRunSessionDevice {
"""Human-readable device name to show to users (e.g. "Pixel 9")."""
displayName: String!
"""
AVD hardware profile id accepted by android.deviceIdentifier (e.g. "pixel_9").
"""
identifier: String!
}
type AndroidDeviceRunSessionProfiles {
devices: [AndroidDeviceRunSessionDevice!]!
}
type AndroidFcm {
account: Account!
createdAt: DateTime!
"""
Legacy FCM: returns the Cloud Messaging token, parses to a String
FCM v1: returns the Service Account Key file, parses to an Object
"""
credential: JSON!
id: ID!
snippet: FcmSnippet!
updatedAt: DateTime!
version: AndroidFcmVersion!
}
input AndroidFcmInput {
credential: String!
version: AndroidFcmVersion!
}
type AndroidFcmMutation {
"""Create an FCM V0/Legacy credential"""
createAndroidFcm(accountId: ID!, androidFcmInput: AndroidFcmInput!): AndroidFcm! @deprecated(reason: "FCM Legacy credentials are no longer supported by Google. Use createFcmV1Credential instead.")
"""Delete an FCM V0/Legacy credential"""
deleteAndroidFcm(id: ID!): deleteAndroidFcmResult!
}
enum AndroidFcmVersion {
LEGACY
V1
}
input AndroidJobBuildCredentialsInput {
keystore: AndroidJobKeystoreInput!
}
input AndroidJobInput {
applicationArchivePath: String
"""@deprecated"""
artifactPath: String
buildArtifactPaths: [String!]
buildProfile: String
buildType: AndroidBuildType
builderEnvironment: AndroidBuilderEnvironmentInput
cache: BuildCacheInput
customBuildConfig: CustomBuildConfigInput
developmentClient: Boolean
environment: EnvironmentVariableEnvironment
experimental: JSONObject
gradleCommand: String
loggerLevel: WorkerLoggerLevel
mode: BuildMode
projectArchive: ProjectArchiveSourceInput!
projectRootDirectory: String!
releaseChannel: String
secrets: AndroidJobSecretsInput
triggeredBy: BuildTrigger
type: BuildWorkflow!
updates: BuildUpdatesInput
username: String
version: AndroidJobVersionInput
}
input AndroidJobKeystoreInput {
dataBase64: String!
keyAlias: String!
keyPassword: String
keystorePassword: String!
}
input AndroidJobOverridesInput {
applicationArchivePath: String
"""@deprecated"""
artifactPath: String
buildArtifactPaths: [String!]
buildProfile: String
buildType: AndroidBuildType
builderEnvironment: AndroidBuilderEnvironmentInput
cache: BuildCacheInput
customBuildConfig: CustomBuildConfigInput
developmentClient: Boolean
experimental: JSONObject
gradleCommand: String
loggerLevel: WorkerLoggerLevel
mode: BuildMode
releaseChannel: String
secrets: AndroidJobSecretsInput
updates: BuildUpdatesInput
username: String
version: AndroidJobVersionInput
}
input AndroidJobSecretsInput {
buildCredentials: AndroidJobBuildCredentialsInput
}
input AndroidJobVersionInput {
versionCode: String!
}
type AndroidKeystore {
account: Account!
createdAt: DateTime!
id: ID!
keyAlias: String!
keyPassword: String
keystore: String!
keystorePassword: String!
md5CertificateFingerprint: String
sha1CertificateFingerprint: String
sha256CertificateFingerprint: String
type: AndroidKeystoreType!
updatedAt: DateTime!
}
input AndroidKeystoreInput {
base64EncodedKeystore: String!
keyAlias: String!
keyPassword: String
keystorePassword: String!
}
type AndroidKeystoreMutation {
"""Create a Keystore"""
createAndroidKeystore(accountId: ID!, androidKeystoreInput: AndroidKeystoreInput!): AndroidKeystore
"""Delete a Keystore"""
deleteAndroidKeystore(id: ID!): DeleteAndroidKeystoreResult!
}
enum AndroidKeystoreType {
JKS
PKCS12
UNKNOWN
}
type AndroidSubmissionConfig {
applicationIdentifier: String @deprecated(reason: "applicationIdentifier is deprecated and will be auto-detected on submit")
releaseStatus: SubmissionAndroidReleaseStatus
rollout: Float
track: String!
}
input AndroidSubmissionConfigInput {
applicationIdentifier: String
changelog: String
changesNotSentForReview: Boolean
googleServiceAccountKeyId: String
googleServiceAccountKeyJson: String
isVerboseFastlaneEnabled: Boolean
releaseStatus: SubmissionAndroidReleaseStatus
rollout: Float
track: SubmissionAndroidTrack!
}
"""Represents an Exponent App (or Experience in legacy terms)"""
type App implements Project {
"""Coalesced project activity for an app"""
activityTimelineProjectActivities(
""" Offset the query """
createdBefore: DateTime
filterChannels: [String!]
filterPlatforms: [AppPlatform!]
""" Types of objects to filter """
filterTypes: [ActivityTimelineProjectActivityType!]
limit: Int!
): [ActivityTimelineProjectActivity!]!
"""Android app credentials for the project"""
androidAppCredentials(filter: AndroidAppCredentialsFilter): [AndroidAppCredentials!]!
appStoreConnectApp: AppStoreConnectApp
"""
Connection status for this project's App Store Connect-triggered workflows.
"""
appStoreConnectWorkflowConnectionStatus: AppStoreConnectWorkflowConnectionStatus!
assetLimitPerUpdateGroup: Int!
branchesPaginated(after: String, before: String, filter: BranchFilterInput, first: Int, last: Int): AppBranchesConnection!
buildProfiles: [String!]!
"""(EAS Build) Builds associated with this app"""
builds(
filter: BuildFilter
limit: Int!
offset: Int!
"""Deprecated, use filter instead"""
platform: AppPlatform
"""Deprecated, use filter instead"""
status: BuildStatus
): [Build!]!
buildsPaginated(after: String, before: String, filter: BuildFilterInput, first: Int, last: Int): AppBuildsConnection!
channelsPaginated(after: String, before: String, filter: ChannelFilterInput, first: Int, last: Int): AppChannelsConnection!
convexProject: ConvexProject
deployment(channel: String!, runtimeVersion: String!): Deployment
"""Deployments associated with this app"""
deployments(after: String, before: String, filter: DeploymentFilterInput, first: Int, last: Int): DeploymentsConnection!
description: String! @deprecated(reason: "Classic updates have been deprecated.")
devDomainName: AppDevDomainName
"""
Every tag used by this app's device run sessions, sorted alphabetically.
"""
deviceRunSessionTags: [String!]!
deviceRunSessionsPaginated(after: String, before: String, filter: DeviceRunSessionFilterInput, first: Int, last: Int): AppDeviceRunSessionsConnection!
embeddedUpdatesPaginated(after: String, before: String, filter: EmbeddedUpdateFilterInput, first: Int, last: Int): AppEmbeddedUpdatesConnection!
"""Environment secrets for an app"""
environmentSecrets(filterNames: [String!]): [EnvironmentSecret!]!
environmentVariableEnvironments: [EnvironmentVariableEnvironment!]!
"""Environment variables for an app"""
environmentVariables(environment: EnvironmentVariableEnvironment, filterNames: [String!]): [EnvironmentVariable!]!
"""Environment variables for an app with decrypted secret values"""
environmentVariablesIncludingSensitive(environment: EnvironmentVariableEnvironment, filterNames: [String!]): [EnvironmentVariableWithSecret!]!
fingerprintsPaginated(after: String, before: String, filter: FingerprintFilterInput, first: Int, last: Int): AppFingerprintsConnection!
fullName: String!
githubBuildTriggers: [GitHubBuildTrigger!]!
githubJobRunTriggers: [GitHubJobRunTrigger!]!
githubRepository: GitHubRepository
githubRepositorySettings: GitHubRepositorySettings
"""
Info about the icon specified in the most recent classic update manifest
"""
icon: AppIcon @deprecated(reason: "Classic updates have been deprecated.")
iconUrl: String @deprecated
id: ID!
"""App query field for querying EAS Insights about this app"""
insights: AppInsights!
internalDistributionBuildPrivacy: AppInternalDistributionBuildPrivacy!
"""iOS app credentials for the project"""
iosAppCredentials(filter: IosAppCredentialsFilter): [IosAppCredentials!]!
"""
Whether this app qualifies for the observe-notification-lapsed-paid experiment
"""
isEligibleForObserveLapsedPaidNotification: Boolean!
"""
Tells you if the project can show the Observe promotional notification. This field is part of
the observe-notification experiment.
"""
isEligibleForObserveNotice: Boolean! @deprecated(reason: "This field is deprecated from its first release. It supplies data for the observe-notification promotion on the project page. It will be removed when the promotion ends. Do not rely on it.")
lastDeletionAttemptTime: DateTime
"""Time of the last user activity (update, branch, submission)."""
latestActivity: DateTime!
latestAppVersionByPlatformAndApplicationIdentifier(applicationIdentifier: String!, platform: AppPlatform!): AppVersion
logRocketProject: LogRocketProject
name: String!
observe: AppObserve!
"""
Whether EAS Observe ingestion is paused for this app. Apps that have not configured the setting
are treated as false (ingestion enabled). An account-level pause takes precedence.
"""
observeIngestionPaused: Boolean!
ownerAccount: Account!
packageName: String! @deprecated
posthogProject: PostHogProject
privacy: String! @deprecated
profileImageUrl(width: AppProfileImageWidth): String
"""Whether there have been any classic update publishes"""
published: Boolean! @deprecated(reason: "Classic updates have been deprecated.")
"""App query field for querying details about an app's push notifications"""
pushNotifications: AppPushNotifications!
pushSecurityEnabled: Boolean!
resourceClassExperiment: ResourceClassExperiment
"""Runtimes associated with this app"""
runtimes(after: String, before: String, filter: RuntimeFilterInput, first: Int, last: Int): RuntimesConnection!
scopeKey: String!
"""SDK version of the latest classic update publish, 0.0.0 otherwise"""
sdkVersion: String! @deprecated(reason: "Classic updates have been deprecated.")
sentryProject: SentryProject
slug: String!
"""EAS Submissions associated with this app"""
submissions(filter: SubmissionFilter!, limit: Int!, offset: Int!): [Submission!]!
submissionsPaginated(after: String, before: String, first: Int, last: Int): AppSubmissionsConnection!
suggestedDevDomainName: String!
supabaseProject: SupabaseProject
"""Coalesced project activity for an app using pagination"""
timelineActivity(after: String, before: String, filter: TimelineActivityFilterInput, first: Int, last: Int): TimelineActivityConnection!
turtleBrownfieldArtifactsPaginated(after: String, before: String, filter: BrownfieldArtifactFilterInput, first: Int, last: Int): BrownfieldArtifactsConnection!
"""get an EAS branch owned by the app by name"""
updateBranchByName(name: String!): UpdateBranch
"""EAS branches owned by an app"""
updateBranches(limit: Int!, offset: Int!): [UpdateBranch!]!
"""get an EAS channel owned by the app by name"""
updateChannelByName(name: String!): UpdateChannel
"""EAS channels owned by an app"""
updateChannels(limit: Int!, offset: Int!): [UpdateChannel!]!
"""EAS updates owned by an app grouped by update group"""
updateGroups(filter: UpdatesFilter, limit: Int!, offset: Int!): [[Update!]!]!
"""Time of last classic update publish"""
updated: DateTime! @deprecated(reason: "Classic updates have been deprecated.")
"""EAS updates owned by an app"""
updates(limit: Int!, offset: Int!): [Update!]!
updatesPaginated(after: String, before: String, filter: UpdateFilterInput, first: Int, last: Int): AppUpdatesConnection!
updatesTimeline(after: String, before: String, filter: UpdatesTimelineFilter, first: Int, last: Int): UpdatesTimelineConnection!
"""Project query object for querying EAS usage metrics"""
usageMetrics: AppUsageMetrics!
username: String! @deprecated(reason: "Use ownerAccount.name instead")
vexoApp: VexoApp
"""Notification preferences of the viewer for this app"""
viewerNotificationPreferences: [NotificationPreferenceItem!]!
"""Webhooks for an app"""
webhooks(filter: WebhookFilter): [Webhook!]!
workerCustomDomain: WorkerCustomDomain
workerDeployment(deploymentIdentifier: WorkerDeploymentIdentifier!): WorkerDeployment
workerDeploymentAlias(aliasName: WorkerDeploymentIdentifier): WorkerDeploymentAlias
workerDeploymentAliases(after: String, before: String, first: Int, last: Int): WorkerDeploymentAliasesConnection!
workerDeployments(after: String, before: String, first: Int, last: Int): WorkerDeploymentsConnection!
workerDeploymentsCrash(crashKey: ID!, sampleFor: CrashSampleFor): WorkerDeploymentCrashEdge!
workerDeploymentsCrashes(filters: CrashesFilters, timespan: DatasetTimespan!): WorkerDeploymentCrashes
workerDeploymentsRequest(requestKey: ID!): WorkerDeploymentRequestEdge!
workerDeploymentsRequests(filters: RequestsFilters, timespan: DatasetTimespan!): WorkerDeploymentRequests
"""
Caches associated with this app, ordered by last access time (most recent first).
"""
workflowCachesPaginated(after: String, before: String, first: Int, last: Int): AppWorkflowCachesConnection!
"""Per-type caching configuration for this app."""
workflowCachingConfig: WorkflowCachingConfig!
workflowDeviceTestCaseHistory(filters: WorkflowDeviceTestCaseHistoryFiltersInput, path: String!, timespan: WorkflowDeviceTestCaseInsightsTimespanInput!): WorkflowDeviceTestCaseHistory!
workflowDeviceTestCaseInsights(filters: WorkflowDeviceTestCaseInsightsFiltersInput, timespan: WorkflowDeviceTestCaseInsightsTimespanInput!): WorkflowDeviceTestCaseInsights!
workflowRunGitBranchesPaginated(after: String, before: String, filter: WorkflowRunGitBranchFilterInput, first: Int, last: Int): AppWorkflowRunGitBranchesConnection!
workflowRunsPaginated(after: String, before: String, filter: AppWorkflowRunFilterInput, first: Int, last: Int): AppWorkflowRunsConnection!
workflows(filter: AppWorkflowFilterInput): [Workflow!]!
workflowsInsights: AppWorkflowsInsights!
}
type AppBranchEdge {
cursor: String!
node: UpdateBranch!
}
type AppBranchesConnection {
edges: [AppBranchEdge!]!
pageInfo: PageInfo!
}
type AppBuildEdge {
cursor: String!
node: BuildOrBuildJob!
}
type AppBuildsConnection {
edges: [AppBuildEdge!]!
pageInfo: PageInfo!
}
type AppChannelEdge {
cursor: String!
node: UpdateChannel!
}
type AppChannelsConnection {
edges: [AppChannelEdge!]!
pageInfo: PageInfo!
}
input AppDataInput {
id: ID!
internalDistributionBuildPrivacy: AppInternalDistributionBuildPrivacy
privacy: String
}
type AppDevDomainName {
app: App
id: ID!
name: DevDomainName!
}
type AppDevDomainNameMutation {
"""Creates a DevDomainName assigning it to an app"""
assignDevDomainName(appId: ID!, name: DevDomainName!): AppDevDomainName!
"""Updates a DevDomainName for a given app"""
changeDevDomainName(appId: ID!, name: DevDomainName!): AppDevDomainName!
}
type AppDeviceRunSessionEdge {
cursor: String!
node: DeviceRunSession!
}
type AppDeviceRunSessionsConnection {
edges: [AppDeviceRunSessionEdge!]!
pageInfo: PageInfo!
}
type AppEmbeddedUpdateEdge {
cursor: String!
node: EmbeddedUpdate!
}
type AppEmbeddedUpdatesConnection {
edges: [AppEmbeddedUpdateEdge!]!
pageInfo: PageInfo!
}
type AppFingerprintEdge {
cursor: String!
node: Fingerprint!
}
type AppFingerprintsConnection {
edges: [AppFingerprintEdge!]!
pageInfo: PageInfo!
}
type AppIcon {
originalUrl: String!
primaryColor: String
url: String!
}
input AppInfoInput {
displayName: String
}
input AppInput {
accountId: ID!
appInfo: AppInfoInput
projectName: String!
}
type AppInsights {
hasEventsFromExpoInsightsClientModule: Boolean!
totalUniqueUsers(timespan: InsightsTimespan!): Int
uniqueUsersByAppVersionOverTime(timespan: InsightsTimespan!): UniqueUsersOverTimeData!
uniqueUsersByPlatformOverTime(timespan: InsightsTimespan!): UniqueUsersOverTimeData!
}
enum AppInternalDistributionBuildPrivacy {
PRIVATE
PUBLIC
}
type AppMutation {
"""Create an app"""
createApp(appInput: AppInput!): App!
"""
Remove profile image (icon) for the app. Do nothing if there's no profile image associated.
"""
removeProfileImage(appId: ID!): App!
"""
Delete an App. Returns the ID of the background job receipt. Use BackgroundJobReceiptQuery to get the status of the job.
"""
scheduleAppDeletion(appId: ID!): BackgroundJobReceipt!
"""Set display info for app"""
setAppInfo(appId: ID!, appInfo: AppInfoInput!): App!
"""
Set whether EAS Observe ingestion is paused for this app. Requires the ADMIN permission on
the owning account. An account-level pause takes precedence over this setting.
"""
setObserveIngestionPaused(appId: ID!, paused: Boolean!): App!
"""Require api token to send push notifs for experience"""
setPushSecurityEnabled(appId: ID!, pushSecurityEnabled: Boolean!): App!
"""Set resource class experiment for app"""
setResourceClassExperiment(appId: ID!, resourceClassExperiment: ResourceClassExperiment): App!
"""Set per-type caching configuration for the app."""
setWorkflowCachingConfig(appId: ID!, config: WorkflowCachingConfigInput!): App!
}
"""App-level notification preference"""
type AppNotificationPreference implements NotificationPreference {
app: App!
enabled: Boolean!
event: NotificationEvent!
type: NotificationType!
}
input AppNotificationPreferenceInput {
appId: ID!
enabled: Boolean!
event: NotificationEvent!
type: NotificationType!
}
type AppObserve {
appVersions(input: AppObserveReleasesInput!): [AppObserveAppVersion!]!
customEventList(after: String, before: String, filter: AppObserveCustomEventListFilter, first: Int, last: Int, orderBy: AppObserveCustomEventListOrderBy): AppObserveCustomEventListConnection! @deprecated(reason: "Use userEvents.list (or errors.occurrences for exceptions) instead.")
customEventNames(
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
endTime: DateTime!
environment: String
isEmbeddedUpdate: Boolean
orderBy: AppObserveCustomEventNamesOrderBy
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
startTime: DateTime!
): AppObserveCustomEventNames! @deprecated(reason: "Use userEvents.names instead.")
"""
Namespaced successor API (ENG-26160). Prefer over the flat `updates` field.
"""
easUpdates: AppObserveEasUpdates!
environments(
endTime: DateTime
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
startTime: DateTime
): [String!]!
"""
Distinct unhandled-JS-error groups (the issues list), grouped by fingerprint.
"""
errorGroups(input: AppObserveErrorGroupsInput!): AppObserveErrorGroups! @deprecated(reason: "Use errors.groups instead.")
"""
Headline error stats for the overview: crash-free rates and error/affected counts.
"""
errorStats(input: AppObserveErrorStatsInput!): AppObserveErrorStats! @deprecated(reason: "Use errors.stats instead.")
"""
Namespaced successor API (ENG-26160). Prefer over the flat `errorGroups`/`errorStats` fields.
"""
errors: AppObserveErrors!
events(after: String, before: String, filter: AppObserveEventsFilter, first: Int, last: Int, orderBy: AppObserveEventsOrderBy): AppObserveEventsConnection! @deprecated(reason: "Use metrics.list instead.")
"""
Highest Expo SDK version seen in telemetry over the trailing 30 days; null when none was reported.
"""
latestExpoSdkVersion: String
"""
A single log (user-defined event or error) by `event_id`. Null when missing or aged out of retention.
"""
log(id: ID!): AppObserveLog
"""
Namespaced successor API (ENG-26160). Prefer over the flat `timeSeries`/`events` fields.
"""
metrics: AppObserveMetrics!
"""
Namespaced successor API (ENG-26160). Prefer over the flat `navigationRoutes` field.
"""
navigation: AppObserveNavigation!
navigationRoutes(after: String, before: String, filter: AppObserveNavigationRoutesFilter!, first: Int, last: Int, orderBy: AppObserveNavigationRoutesOrderBy): AppObserveNavigationRoutesConnection! @deprecated(reason: "Use navigation.routes instead.")
"""
Namespaced successor API (ENG-26160). Prefer over the flat `overview*` fields.
"""
overview: AppObserveOverview!
"""
Active users and sessions for the Overview engagement band, across all versions.
"""
overviewEngagement(input: AppObserveOverviewEngagementInput!): AppObserveOverviewEngagement! @deprecated(reason: "Use overview.engagement instead.")
"""
Crash-free rates with previous-period comparison for the Overview stability tiles.
"""
overviewStability(input: AppObserveOverviewStabilityInput!): AppObserveOverviewStability! @deprecated(reason: "Use overview.stability instead.")
"""
Per-version, per-platform metric summaries for the Overview version-comparison matrix.
"""
overviewVersionComparison(input: AppObserveOverviewVersionComparisonInput!): AppObserveOverviewVersionComparison! @deprecated(reason: "Use overview.versionComparison instead.")
"""
One session's metrics and logs for the timeline (ENG-26160). Unknown session ids yield empty lists.
"""
session(id: ID!): AppObserveSession!
timeSeries(input: AppObserveTimeSeriesInput!): AppObserveTimeSeries! @deprecated(reason: "Use metrics.timeSeries instead.")
totalEventCount: Int!
"""
Approximate count of unique users (`eas_client_id`) with at least one
supported-metric event in `[startTime, endTime)`. Uses a ClickHouse
HyperLogLog sketch, so the value can drift by a small percent on apps
with very large user bases. `metricNames` on the input is currently
ignored: the count is always over all supported metrics, matching the
universe used by `appVersions` headline counts.
"""
uniqueActiveUserCount(input: AppObserveReleasesInput!): Int!
"""
Update download activity (the Recent updates list). Not available on the free tier or legacy plans.
"""
updates(input: AppObserveUpdatesInput!): AppObserveUpdatesConnection! @deprecated(reason: "Use easUpdates.list instead.")
"""
Namespaced successor API (ENG-26160). Prefer over the flat `customEventNames`/`customEventList` fields.
"""
userEvents: AppObserveUserEvents!
}
type AppObserveAppBuildEmbeddedSummary {
eventCount: Int!
firstSeenAt: DateTime!
"""
Unique users whose most recent supported-metric event in the queried
range ran this build's embedded bundle.
"""
lastSeenUserCount: Int!
uniqueUserCount: Int!
}
type AppObserveAppBuildNumber {
appBuildNumber: String!
easBuilds: [AppObserveAppEasBuild!]!
"""
Summary restricted to events running this build's embedded bundle
(no OTA update applied). Null when the build has no such events
in the queried time range.
"""
embedded: AppObserveAppBuildEmbeddedSummary
eventCount: Int!
firstSeenAt: DateTime!
"""
Unique users whose most recent supported-metric event in the queried
range was on this (appVersion, appBuildNumber) tuple.
"""
lastSeenUserCount: Int!
uniqueUserCount: Int!
"""
Updates seen on this build number in the queried time range. Each
entry's counts and EAS builds are scoped to this (appVersion,
appBuildNumber, appUpdateId) tuple.
"""
updates: [AppObserveAppUpdate!]!
}
type AppObserveAppEasBuild {
easBuildId: String!
eventCount: Int!
firstSeenAt: DateTime!
uniqueUserCount: Int!
}
type AppObserveAppUpdate {
appUpdateId: String!
appUpdateMessage: String
easBuilds: [AppObserveAppEasBuild!]!
eventCount: Int!
firstSeenAt: DateTime!
"""
Unique users whose most recent supported-metric event in the queried
range matched this update at its current nesting level.
"""
lastSeenUserCount: Int!
uniqueUserCount: Int!
}
type AppObserveAppVersion {
appVersion: String!
buildNumbers: [AppObserveAppBuildNumber!]!
eventCount: Int!
firstSeenAt: DateTime!
"""
Unique users whose most recent supported-metric event in
`[startTime, endTime)` was on this version. Each active user
contributes to exactly one version, so summing this field across the
returned versions yields the total active users in the window (equal
to `AppObserve.uniqueActiveUserCount` up to HyperLogLog noise).
A version may be returned with `lastSeenUserCount = 0` when
every user who touched it later moved to a newer version. Users with
no events in the window are not counted on any version.
"""
lastSeenUserCount: Int!
metrics: [AppObserveAppVersionMetric!]!
uniqueUserCount: Int!
updates: [AppObserveAppUpdate!]!
}
type AppObserveAppVersionMetric {
eventCount: Int!
metricName: String!
statistics: AppObserveVersionMarkerStatistics!
}
type AppObserveCustomEvent {
appBuildNumber: String!
appEasBuildId: String
appIdentifier: String!
appUpdateId: String
appUpdateMessage: String
appVersion: String!
body: String
clientVersion: String
countryCode: String
deviceLanguageTag: String
deviceModel: String!
deviceOs: String!
deviceOsVersion: String!
"""
Human-friendly label from the expo.log.display_name attribute; null when the event was logged without one.
"""
displayName: String
easClientId: String!
environment: String
errorFingerprint: String
errorSource: String
eventName: String!
exceptionMessage: String
"""
Symbolicated when a build or update with a matching source map exists; otherwise as reported.
"""
exceptionStacktrace: String
"""
Error fields below are populated only for exception events (eventName: exception).
"""
exceptionType: String
expoSdkVersion: String
id: ID!
ingestedAt: DateTime
isFatal: Boolean
properties: [AppObserveEventProperty!]!
reactNativeVersion: String
sessionId: String
severityNumber: Int
severityText: String
"""
Build whose uploaded source map symbolicated exceptionStacktrace; null when the stack trace is shown as reported or was symbolicated from an update.
"""
symbolicationBuild: Build
"""
Update whose uploaded source map symbolicated exceptionStacktrace; null when the stack trace is shown as reported or was symbolicated from a build.
"""
symbolicationUpdate: Update
timestamp: DateTime!
}
type AppObserveCustomEventEdge {
cursor: String!
node: AppObserveCustomEvent!
}
type AppObserveCustomEventListConnection {
edges: [AppObserveCustomEventEdge!]!
pageInfo: PageInfo!
}
input AppObserveCustomEventListFilter {
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
countryCode: String
deviceModel: String
deviceOsVersion: String
easClientId: String
endTime: DateTime
environment: String
"""
Restrict to one error group. Combine with the exception eventName to list a group's occurrences.
"""
errorFingerprint: String
eventName: String
isEmbeddedUpdate: Boolean
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
propertyFilters: [AppObserveCustomEventPropertyFilter!]
sessionId: String
startTime: DateTime
}
input AppObserveCustomEventListOrderBy {
direction: AppObserveEventsOrderByDirection!
field: AppObserveCustomEventListOrderByField!
}
enum AppObserveCustomEventListOrderByField {
TIMESTAMP
}
type AppObserveCustomEventName {
count: Int!
eventName: String!
}
type AppObserveCustomEventNames {
isTruncated: Boolean!
names: [AppObserveCustomEventName!]!
}
input AppObserveCustomEventNamesOrderBy {
direction: AppObserveCustomEventNamesOrderByDirection!
field: AppObserveCustomEventNamesOrderByField!
}
enum AppObserveCustomEventNamesOrderByDirection {
ASC
DESC
}
enum AppObserveCustomEventNamesOrderByField {
COUNT
EVENT_NAME
}
input AppObserveCustomEventPropertyFilter {
key: String!
value: String!
}
"""
EAS Update download activity (app_metrics download samples plus update metadata).
"""
type AppObserveEasUpdates {
"""
Updates with download statistics. Forward pagination only. Defaults to newest first.
"""
list(after: String, filter: AppObserveEasUpdatesFilter!, first: Int, orderBy: AppObserveEasUpdatesOrderBy): AppObserveUpdatesConnection!
}
input AppObserveEasUpdatesFilter {
appBuildNumber: String
appUpdateId: String
appVersion: String
endTime: DateTime!
environment: String
"""Filter to these platforms."""
platforms: [AppObservePlatform!]
startTime: DateTime!
}
input AppObserveEasUpdatesOrderBy {
direction: AppObserveOrderDirection!
field: AppObserveUpdatesOrderByField!
}
input AppObserveEngagementInput {
"""Series bucket size. Defaults to one day."""
bucketIntervalMinutes: Int
endTime: DateTime!
environment: String
"""Filter to these platforms."""
platforms: [AppObservePlatform!]
startTime: DateTime!
}
"""One error or crash (an app_events *.exception row)."""
type AppObserveError implements AppObserveLog {
appBuildNumber: String!
appEasBuildId: String
appIdentifier: String!
appUpdateId: String
appUpdateMessage: String
appVersion: String!
body: String
clientVersion: String
countryCode: String
deviceLanguageTag: String
deviceModel: String!
deviceOs: String!
deviceOsVersion: String!
easClientId: String!
environment: String
"""Raw log event name, e.g. exception, js.exception, native.exception."""
eventName: String!
expoSdkVersion: String
fingerprint: String
id: ID!
ingestedAt: DateTime
isFatal: Boolean
kind: AppObserveErrorKind!
message: String
properties: [AppObserveEventProperty!]!
reactNativeVersion: String
sessionId: String
severityNumber: Int
severityText: String
source: String
"""
Symbolicated when a build or update with a matching source map exists; otherwise as reported.
"""
stacktrace: String
"""
Build whose uploaded source map symbolicated stacktrace; null when the stack trace is shown as reported or was symbolicated from an update.
"""
symbolicationBuild: Build
"""
Update whose uploaded source map symbolicated stacktrace; null when the stack trace is shown as reported or was symbolicated from a build.
"""
symbolicationUpdate: Update
timestamp: DateTime!
type: String
}
type AppObserveErrorBreakdownBucket {
count: Int!
"""
Dimension value (app version, OS, device model, or country code). Empty string when unknown.
"""
key: String!
uniqueUserCount: Int!
}
enum AppObserveErrorBreakdownDimension {
APP_VERSION
COUNTRY
DEVICE
OS
}
type AppObserveErrorConnection {
edges: [AppObserveErrorEdge!]!
pageInfo: PageInfo!
}
type AppObserveErrorEdge {
cursor: String!
node: AppObserveError!
}
type AppObserveErrorGroup {
affectedSessionCount: Int!
"""
How the error was captured, from the most recent occurrence (e.g. global).
"""
errorSource: String
eventCount: Int!
"""Error message, from the most recent occurrence."""
exceptionMessage: String
"""Error class/type, from the most recent occurrence (e.g. TypeError)."""
exceptionType: String
"""
Stable grouping key (sha256 over error kind + error type + entropy-normalized message).
"""
fingerprint: String!
firstSeenAt: DateTime!
isFatal: Boolean!
"""Derived from the event name of the most recent occurrence."""
kind: AppObserveErrorKind!
lastSeenAt: DateTime!
"""
Per-platform occurrence and unique-user counts, sorted by eventCount descending. Covers every device OS seen (iOS, Android, iPadOS, ...), so the counts sum to the group totals.
"""
platformCounts: [AppObserveErrorGroupPlatformCount!]!
"""Distinct device OS values seen for this group (e.g. Android, iOS)."""
platforms: [String!]!
"""FATAL if any occurrence in the group was fatal, otherwise ERROR."""
severity: AppObserveErrorSeverity!
"""
Occurrences over the query window, bucketed ascending. Sparse (empty buckets omitted); the client fills gaps. Renders as the list sparkline. Bucket width is set via AppObserveErrorGroupsInput.bucketIntervalMinutes.
"""
timeSeries: [AppObserveErrorTimeSeriesBucket!]!
uniqueUserCount: Int!
}
type AppObserveErrorGroupBreakdown {
"""Buckets ordered by count descending."""
buckets: [AppObserveErrorBreakdownBucket!]!
"""True when more buckets exist than were returned (top-N truncation)."""
isTruncated: Boolean!
}
"""
Filters for the per-group breakdown. Same release/time/platform filters used across Observe.
"""
input AppObserveErrorGroupBreakdownInput {
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
dimension: AppObserveErrorBreakdownDimension!
endTime: DateTime!
environment: String
fingerprint: String!
isEmbeddedUpdate: Boolean
"""
Restrict to one error kind (JS errors, native crashes, or other *.exception events).
"""
kind: AppObserveErrorKind
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
startTime: DateTime!
}
type AppObserveErrorGroupPlatformCount {
eventCount: Int!
"""Device OS value, e.g. iOS, Android, iPadOS."""
platform: String!
uniqueUserCount: Int!
}
type AppObserveErrorGroups {
groups: [AppObserveErrorGroup!]!
"""True when more groups exist than were returned (top-N truncation)."""
isTruncated: Boolean!
}
input AppObserveErrorGroupsInput {
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
"""
Bucket width in minutes for the per-group timeSeries field. Only used when timeSeries is selected. Defaults to 1440 (daily).
"""
bucketIntervalMinutes: Int
endTime: DateTime!
environment: String
"""
Restrict to a single group, e.g. to fetch one group's header on the detail page.
"""
fingerprint: String
isEmbeddedUpdate: Boolean
"""
Restrict to one error kind (JS errors, native crashes, or other *.exception events).
"""
kind: AppObserveErrorKind
orderBy: AppObserveErrorGroupsOrderBy
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
"""Restrict to fatal-only or non-fatal-only errors."""
severity: AppObserveErrorSeverity
"""Restrict to a capture source (e.g. global)."""
source: String
startTime: DateTime!
}
enum AppObserveErrorGroupsOrderBy {
FIRST_SEEN
LAST_SEEN
MOST_FREQUENT
MOST_USERS
}
"""
JS covers both the legacy exception name and js.exception. NATIVE is native.exception. OTHER is any other *.exception event.
"""
enum AppObserveErrorKind {
JS
NATIVE
OTHER
}
input AppObserveErrorOccurrencesFilter {
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
countryCode: String
deviceModel: String
easClientId: String
endTime: DateTime
environment: String
"""Restrict to one error group."""
fingerprint: String
isEmbeddedUpdate: Boolean
"""
Restrict to one error kind (JS errors, native crashes, or other *.exception events).
"""
kind: AppObserveErrorKind
"""Filter to these platforms."""
platforms: [AppObservePlatform!]
sessionId: String
startTime: DateTime
}
input AppObserveErrorOccurrencesOrderBy {
direction: AppObserveOrderDirection!
field: AppObserveErrorOccurrencesOrderByField!
}
enum AppObserveErrorOccurrencesOrderByField {
TIMESTAMP
}
"""AppObserveErrorStats for one platform; iOS includes iPadOS and tvOS."""
type AppObserveErrorPlatformStats {
"""Distinct sessions on this platform that hit any exception."""
affectedSessions: Int!
"""Distinct users on this platform that hit any exception."""
affectedUsers: Int!
"""
Fraction (0..1) of this platform's active sessions without a fatal error.
"""
crashFreeSessions: Float!
"""Fraction (0..1) of this platform's active users without a fatal error."""
crashFreeUsers: Float!
fatalCount: Int!
nonFatalCount: Int!
platform: AppObservePlatform!
"""Total exception events in range on this platform."""
totalErrors: Int!
}
enum AppObserveErrorSeverity {
ERROR
FATAL
}
type AppObserveErrorStats {
"""Distinct sessions that hit any exception."""
affectedSessions: Int!
"""Distinct users that hit any exception."""
affectedUsers: Int!
"""
Fraction (0..1) of active sessions without a fatal error. Denominator spans app_metrics and app_events.
"""
crashFreeSessions: Float!
"""Fraction (0..1) of active users without a fatal error."""
crashFreeUsers: Float!
fatalCount: Int!
nonFatalCount: Int!
"""Total exception events in range."""
totalErrors: Int!
}
"""
Filters for the error-stats header. Same release/time/platform filters used across Observe.
"""
input AppObserveErrorStatsInput {
appBuildNumber: String
appEasBuildId: String
appUpdateId: String
appVersion: String
endTime: DateTime!
environment: String
isEmbeddedUpdate: Boolean
"""
Restrict to one error kind (JS errors, native crashes, or other *.exception events).
"""
kind: AppObserveErrorKind
platform: AppObservePlatform
"""Filter to these platforms. Cannot be set together with platform."""
platforms: [AppObservePlatform!]
startTime: DateTime!
}
type AppObserveErrorTimeSeries {
buckets: [AppObserveErrorTimeSeriesBucket!]!
"""Sum of fatalCount across all buckets."""
totalFatalCount: Int!
"""Sum of nonFatalCount across all buckets."""