# Object types (/api/objects) {/* AUTO-GENERATED by scripts/generate-graphql-docs.mjs from @alternatefutures/backend@0.1.2. Do not edit by hand. */} Generated from the API server source (@alternatefutures/backend 0.1.2) on every merge. Endpoint `https://api.alternatefutures.ai/graphql`, header `Authorization: Bearer `. See the [GraphQL API overview](/api) for how to call it. Left out on purpose: provider-specific types, fields and arguments; operations of the retired hosting product (sites, IPFS storage, functions) and admin-only operations. ## User & authentication [#user--authentication] ### User [#user] | Field | Type | Description | | --------------- | ----------------------------------------------- | ----------- | | `id` | `ID!` | | | `email` | `String` | | | `username` | `String` | | | `walletAddress` | `String` | | | `projects` | `[Project!]!` · [Project](/api/objects#project) | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### PersonalAccessToken [#personalaccesstoken] PersonalAccessToken type for listing tokens (token value excluded for security) | Field | Type | Description | | ------------- | --------- | ----------- | | `id` | `ID!` | | | `name` | `String!` | | | `maskedToken` | `String` | | | `expiresAt` | `Date` | | | `lastUsedAt` | `Date` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### PersonalAccessTokenList [#personalaccesstokenlist] Wrapper type for tokens list (SDK compatibility) | Field | Type | Description | | ------ | ----------------------------------------------------------------------------------- | ----------- | | `data` | `[PersonalAccessToken!]!` · [PersonalAccessToken](/api/objects#personalaccesstoken) | | ### PersonalAccessTokenCreated [#personalaccesstokencreated] PersonalAccessTokenCreated type returned when creating a new token Includes the token value which is only shown once during creation | Field | Type | Description | | ------------ | --------- | ----------- | | `id` | `ID!` | | | `name` | `String!` | | | `token` | `String!` | | | `expiresAt` | `Date` | | | `lastUsedAt` | `Date` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### ApiKeyRateLimit [#apikeyratelimit] | Field | Type | Description | | ----------------- | ------- | ----------- | | `remaining` | `Int!` | | | `limit` | `Int!` | | | `resetAt` | `Date!` | | | `activeTokens` | `Int!` | | | `maxActiveTokens` | `Int!` | | ## Projects [#projects] ### Project [#project] | Field | Type | Description | | ------------------------- | ----------------------------------- | ------------------------------------------------- | | `id` | `ID!` | | | `name` | `String!` | | | `slug` | `String!` | | | `organizationId` | `ID` | Owning organization; null for a personal project. | | `avatar` | `String` | | | `backupStorageOnArweave` | `Boolean` | | | `backupStorageOnFilecoin` | `Boolean` | | | `user` | `User!` · [User](/api/objects#user) | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | | † | | Some fields omitted | ### ProjectList [#projectlist] Wrapper type for paginated project list (SDK compatibility) | Field | Type | Description | | ------ | ----------------------------------------------- | ----------- | | `data` | `[Project!]!` · [Project](/api/objects#project) | | ### ProjectChatSession [#projectchatsession] Everything a client needs to join a project's chat room. TRUST MODEL: relay-blind, NOT end-to-end. The chat relay only ever sees ciphertext, but the platform issues and stores the secret, so the platform can read project chat. True end-to-end with membership changes is MLS (E2EE hardening roadmap item 1) and is not built. | Field | Type | Description | | ----------------- | --------- | ------------------------------------------------------------------------ | | `room` | `String!` | Relay room id: use verbatim; never derive it client-side. | | `relayWsUrl` | `String!` | Public relay WebSocket endpoint, e.g. wss\://chat.alternatefutures.ai/ws | | `ticket` | `String!` | Single-use join ticket. Every (re)connect needs a fresh one. | | `ticketExpiresAt` | `String!` | ISO-8601 expiry of the ticket (\~30s out). | | `secret` | `String!` | Per-project room secret; the client derives the AES key from it. | ### PublicChatTicket [#publicchatticket] A single-use join ticket for the HOSTED public chat (chat.alternatefutures.ai). TRUST MODEL: the ticket is NOT bound to a room. The platform learns WHO opened hosted public chat and WHEN, never WHICH room or with whom: the relay redeems it as roomClass: "public" with no room id. Passphrase rooms stay end-to-end encrypted and opaque to the platform. | Field | Type | Description | | ----------------- | --------- | ------------------------------------------------------------ | | `ticket` | `String!` | Single-use join ticket. Every (re)connect needs a fresh one. | | `ticketExpiresAt` | `String!` | ISO-8601 expiry of the ticket (\~30s out). | ## Service registry (canonical workloads) [#service-registry-canonical-workloads] ### Service [#service] | Field | Type | Description | | ------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `ID!` | | | `type` | `ServiceType!` · [ServiceType](/api/enums#servicetype) | | | `name` | `String!` | | | `slug` | `String!` | | | `projectId` | `ID!` | | | `flavor` | `String` | Create-time discriminator describing the catalog flow that produced this service. One of 'docker' \| 'server' \| 'function' \| 'template'. Null on legacy rows; the web app falls through to 'docker' for VM rows and 'function' for FUNCTION rows. Immutable after creation. | | `templateId` | `ID` | | | `dockerImage` | `String` | | | `containerPort` | `Int` | | | `volumes` | `JSON` | Persistent volumes for raw Docker images. Templates use template.persistentStorage instead. Shape: Array\<\{ name: string; mountPath: string; size: string }>. | | `healthProbe` | `JSON` | Optional application HTTP health probe. Shape: JSON object with path (required, must start with /), optional port, expectStatus (default 200), intervalSec (default 30, clamped 10-3600), and timeoutSec (default 5, clamped 1-30). Null when no probe is configured. | | `applicationHealth` | `ApplicationHealth` · [ApplicationHealth](/api/objects#applicationhealth) | Live application-level health derived from the configured healthProbe. Null until the runner has fired at least one probe. | | `failoverPolicy` | `JSON` | Optional health-aware auto-failover policy. Shape: JSON object with enabled (boolean), maxAttempts (default 3, clamped 1-10), and windowHours (default 24, clamped 1-720). When enabled, the sweeper redeploys to a different provider on provider-side failures rather than plain-closing the deployment. Refused for services with persistent volumes (data-loss risk) and for application-side failures. | | `failoverHistory` | `FailoverHistory` · [FailoverHistory](/api/objects#failoverhistory) | Live failover history derived from this service's deployment chain. Null when no failover has ever fired for this service. | | `internalHostname` | `String` | | | `createdByUserId` | `ID` | | | `parentServiceId` | `ID` | | | `sdlServiceName` | `String` | | | `shutdownPriority` | `Int!` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | | `metrics` | `ServiceDeploymentMetrics!` · [ServiceDeploymentMetrics](/api/objects#servicedeploymentmetrics) | | | `envVars` | `[ServiceEnvVar!]!` · [ServiceEnvVar](/api/objects#serviceenvvar) | | | `ports` | `[ServicePort!]!` · [ServicePort](/api/objects#serviceport) | | | `linksFrom` | `[ServiceLink!]!` · [ServiceLink](/api/objects#servicelink) | | | `linksTo` | `[ServiceLink!]!` · [ServiceLink](/api/objects#servicelink) | | | `latestBuild` | `BuildJob` · [BuildJob](/api/objects#buildjob) | Latest build attempt for git-source services. Null for non-git services. | | `buildJobs` | `[BuildJob!]!` · [BuildJob](/api/objects#buildjob) | Recent build attempts (newest first), capped per request.Arguments: `limit: Int`. | | `gitProvider` | `String` | Set when this Service is connected to a git repo. One of 'github' \| 'gitlab' \| 'bitbucket'. | | `gitInstallationId` | `ID` | Local id of the GithubInstallation row (or future provider install row). | | `gitOwner` | `String` | | | `gitRepo` | `String` | | | `gitBranch` | `String` | | | `rootDirectory` | `String` | | | `buildCommand` | `String` | | | `startCommand` | `String` | | | `detectedFramework` | `String` | | | `detectedPort` | `Int` | | | `lastBuildSha` | `String` | Most recent built commit SHA. Null until the first build succeeds. | | `lastBuildStatus` | `String` | One of 'PENDING' \| 'RUNNING' \| 'SUCCEEDED' \| 'FAILED' \| 'CANCELED' or null. | | `lastBuildAt` | `Date` | | | † | | Some fields omitted | ## Service deployment metrics [#service-deployment-metrics] ### ServiceDeploymentMetrics [#servicedeploymentmetrics] Aggregate deploy metrics for a single service. Counts combine the live deployment rows (current state: active + per-provider totals) with the ServiceDeployEvent history (how many times, outcomes, last-deployed). Extensible: new scalar fields can be added without reshaping clients. | Field | Type | Description | | ------------------- | -------- | -------------------------------------------------------------------------- | | `totalDeploys` | `Int!` | Real user-intended deploys (excludes retry/failover/resume continuations). | | `totalAttempts` | `Int!` | Every recorded deploy attempt, including retries/failovers/resumes. | | `succeededCount` | `Int!` | Attempts that reached ACTIVE. | | `failedCount` | `Int!` | Attempts that reached a terminal failure. | | `activeCount` | `Int!` | Deployments live right now across all providers. | | `lastDeployedAt` | `String` | ISO-8601 timestamp of the most recent deploy attempt, or null. | | `lastDeployTrigger` | `String` | Trigger of the most recent deploy attempt (MANUAL, RETRY, FAILOVER, …). | | † | | Some fields omitted | ## Service environment variables [#service-environment-variables] ### ServiceEnvVar [#serviceenvvar] | Field | Type | Description | | ----------- | ---------- | ----------- | | `id` | `ID!` | | | `serviceId` | `ID!` | | | `key` | `String!` | | | `value` | `String!` | | | `secret` | `Boolean!` | | | `source` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ## Service port configuration [#service-port-configuration] ### ServicePort [#serviceport] | Field | Type | Description | | --------------- | --------- | ----------- | | `id` | `ID!` | | | `serviceId` | `ID!` | | | `containerPort` | `Int!` | | | `publicPort` | `Int` | | | `protocol` | `String!` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ## Application health [#application-health] ### ProbeResult [#proberesult] Per-attempt result emitted by the application health runner. Newest result is appended to ApplicationHealth.recentResults; the buffer is capped at 20 entries per service. | Field | Type | Description | | ------------ | ---------- | ----------- | | `timestamp` | `Date!` | | | `ok` | `Boolean!` | | | `statusCode` | `Int` | | | `latencyMs` | `Int!` | | | `error` | `String` | | ### ApplicationHealth [#applicationhealth] Aggregated application health derived from the in-memory probe ring buffer. The "overall" field summarises the last 3 results: "healthy" if all pass, "unhealthy" if all fail, "starting" if mixed, "unknown" if no probes have run yet. | Field | Type | Description | | --------------- | ----------------------------------------------------------- | ----------- | | `overall` | `String!` | | | `lastChecked` | `Date` | | | `lastStatus` | `Int` | | | `lastError` | `String` | | | `recentResults` | `[ProbeResult!]!` · [ProbeResult](/api/objects#proberesult) | | ## Failover history [#failover-history] ### FailoverAttempt [#failoverattempt] One entry in the failover chain for a service. Newest first. | Field | Type | Description | | -------------------- | ------------ | ----------- | | `deploymentId` | `ID!` | | | `parentDeploymentId` | `ID` | | | `provider` | `String` | | | `excludedProviders` | `[String!]!` | | | `status` | `String!` | | | `reason` | `String` | | | `createdAt` | `Date!` | | | `deployedAt` | `Date` | | | `closedAt` | `Date` | | ### FailoverHistory [#failoverhistory] Aggregated failover history. attemptsInWindow counts failover-spawned deployments within the configured window (used for cap enforcement). | Field | Type | Description | | ------------------ | ----------------------------------------------------------------------- | ----------- | | `attemptsInWindow` | `Int!` | | | `maxAttempts` | `Int!` | | | `windowHours` | `Int!` | | | `chain` | `[FailoverAttempt!]!` · [FailoverAttempt](/api/objects#failoverattempt) | | ## Service links (inter-service connections) [#service-links-inter-service-connections] ### ServiceLink [#servicelink] | Field | Type | Description | | ----------------- | -------------------------------------------- | ----------- | | `id` | `ID!` | | | `sourceServiceId` | `ID!` | | | `targetServiceId` | `ID!` | | | `sourceService` | `Service!` · [Service](/api/objects#service) | | | `targetService` | `Service!` · [Service](/api/objects#service) | | | `alias` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ## Deployment health (live container status) [#deployment-health-live-container-status] ### ContainerHealth [#containerhealth] | Field | Type | Description | | ----------- | ------------ | ----------- | | `name` | `String!` | | | `status` | `String!` | | | `ready` | `Boolean!` | | | `total` | `Int!` | | | `available` | `Int!` | | | `uris` | `[String!]!` | | | `message` | `String` | | ### DeploymentHealth [#deploymenthealth] | Field | Type | Description | | ------------- | ----------------------------------------------------------------------- | ----------- | | `provider` | `String!` | | | `overall` | `String!` | | | `containers` | `[ContainerHealth!]!` · [ContainerHealth](/api/objects#containerhealth) | | | `lastChecked` | `Date!` | | ## Workspace metrics [#workspace-metrics] ### WorkspaceMetrics [#workspacemetrics] | Field | Type | Description | | ------------- | -------------------------------------------------------------------------- | ----------- | | `compute` | `ComputeMetrics!` · [ComputeMetrics](/api/objects#computemetrics) | | | `deployments` | `DeploymentMetrics!` · [DeploymentMetrics](/api/objects#deploymentmetrics) | | | `spend` | `SpendMetrics!` · [SpendMetrics](/api/objects#spendmetrics) | | ### ComputeMetrics [#computemetrics] | Field | Type | Description | | -------------------- | --------- | ----------- | | `activeDeploys` | `Int!` | | | `totalCpuMillicores` | `Int!` | | | `totalMemoryMb` | `Int!` | | | `formatted` | `String!` | | ### DeploymentMetrics [#deploymentmetrics] | Field | Type | Description | | ----------- | --------- | ----------- | | `active` | `Int!` | | | `total` | `Int!` | | | `formatted` | `String!` | | ### SpendMetrics [#spendmetrics] | Field | Type | Description | | ------------------- | --------- | ----------- | | `currentMonthCents` | `Int!` | | | `formatted` | `String!` | | ## Unified deployments (cross-service view) [#unified-deployments-cross-service-view] ### UnifiedDeployment [#unifieddeployment] | Field | Type | Description | | --------------- | ------------------------------------------------------------------------------------------- | ----------- | | `id` | `ID!` | | | `shortId` | `String!` | | | `status` | `String!` | | | `kind` | `String!` | | | `serviceName` | `String!` | | | `serviceId` | `ID` | | | `serviceSlug` | `String` | | | `serviceType` | `String!` | | | `projectId` | `String` | | | `projectName` | `String` | | | `source` | `String!` | | | `image` | `String` | | | `statusMessage` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date` | | | `author` | `UnifiedDeploymentAuthor` · [UnifiedDeploymentAuthor](/api/objects#unifieddeploymentauthor) | | ### UnifiedDeploymentAuthor [#unifieddeploymentauthor] | Field | Type | Description | | ----------- | --------- | ----------- | | `id` | `ID!` | | | `name` | `String!` | | | `avatarUrl` | `String` | | ## Version & events [#version--events] ### Version [#version] | Field | Type | Description | | ------------ | --------- | ----------- | | `commitHash` | `String!` | | ### ServiceLogResult [#servicelogresult] | Field | Type | Description | | -------------- | --------- | ----------- | | `logs` | `String!` | | | `provider` | `String!` | | | `deploymentId` | `String!` | | | `timestamp` | `Date!` | | ## Attestation registry (org-owned allowlist + verified identities) [#attestation-registry-org-owned-allowlist--verified-identities] ### AttestationMeasurement [#attestationmeasurement] One blessed build measurement in an organization's allowlist. | Field | Type | Description | | ---------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | | `id` | `ID!` | | | `organizationId` | `String!` | | | `measurement` | `String!` | Hex sha256 of the blessed build's app-compose.json (compose\_hash). | | `label` | `String!` | | | `status` | `AttestationRegistryStatus!` · [AttestationRegistryStatus](/api/enums#attestationregistrystatus) | | | `createdAt` | `Date!` | | | `revokedAt` | `Date` | | ### AttestedIdentity [#attestedidentity] A server identity whose quote verified against Intel roots and whose measurement was ACTIVE in the org's allowlist at registration time. | Field | Type | Description | | ---------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | | `id` | `ID!` | | | `organizationId` | `String!` | | | `pubkey` | `String!` | Hex Ed25519 public key, bound by the quote's report\_data. | | `measurementId` | `ID!` | Flat ID ref: resolve details via attestationMeasurements. | | `measurement` | `String!` | The measurement value (compose\_hash) this identity attested to. | | `appId` | `String` | | | `serviceId` | `String` | | | `status` | `AttestationRegistryStatus!` · [AttestationRegistryStatus](/api/enums#attestationregistrystatus) | | | `firstSeenAt` | `Date!` | | | `lastVerifiedAt` | `Date!` | | ## Deployment file access (files tab) [#deployment-file-access-files-tab] ### ServiceFileEntry [#servicefileentry] | Field | Type | Description | | -------- | ------------------------------------------------------------------ | ------------------------------------- | | `name` | `String!` | | | `path` | `String!` | | | `type` | `ServiceFileType!` · [ServiceFileType](/api/enums#servicefiletype) | | | `size` | `Int!` | | | `mtime` | `Date` | | | `target` | `String` | Symlink target, when type is SYMLINK. | ### ServiceFileList [#servicefilelist] | Field | Type | Description | | -------------- | -------------------------------------------------------------------------- | ----------- | | `path` | `String!` | | | `entries` | `[ServiceFileEntry!]!` · [ServiceFileEntry](/api/objects#servicefileentry) | | | `provider` | `String!` | | | `deploymentId` | `String!` | | ### ServiceFileContent [#servicefilecontent] | Field | Type | Description | | -------------- | ---------- | -------------------------------------------------------------- | | `path` | `String!` | | | `content` | `String!` | | | `size` | `Int!` | Total size in bytes: may exceed content length when truncated. | | `truncated` | `Boolean!` | True when the file exceeded the 1 MB read cap. View-only. | | `provider` | `String!` | | | `deploymentId` | `String!` | | ### ServiceFileWriteResult [#servicefilewriteresult] | Field | Type | Description | | -------------- | --------- | ----------- | | `path` | `String!` | | | `bytesWritten` | `Int!` | | ### ServiceFileAccessPolicy [#servicefileaccesspolicy] | Field | Type | Description | | ------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `serviceName` | `String!` | | | `serviceSlug` | `String!` | | | `projectId` | `ID!` | | | `projectName` | `String!` | | | `orgId` | `ID` | | | `mode` | `ServiceFileAccessMode!` · [ServiceFileAccessMode](/api/enums#servicefileaccessmode) | | | `rootPath` | `String!` | Directory the file browser opens at. | | `writablePaths` | `[String!]!` | CONFIG\_ONLY: absolute path prefixes that accept mutations. | | `noteKey` | `String` | i18n key suffix (Services.ServiceFilesPanel.notes.\*) or null. | | `available` | `Boolean!` | Transport-level availability: active deployment + provider support. | | `unavailableReason` | `String` | When available=false: NO\_ACTIVE\_DEPLOYMENT \| FILE\_ACCESS\_UNAVAILABLE. | | `provider` | `String` | | | `shellAccess` | `ServiceShellAccessMode!` · [ServiceShellAccessMode](/api/enums#serviceshellaccessmode) | Unmediated exec policy (terminal, acc ssh, acc cp). NONE = the template hard-locks the box; /ws/shell refuses even the owner. Independent of mode: READ\_ONLY services may still be FULL here. | ## Feedback & bug reports [#feedback--bug-reports] ### FeedbackReport [#feedbackreport] | Field | Type | Description | | ------------- | --------------------------------------------------------------------- | ----------- | | `id` | `ID!` | | | `title` | `String!` | | | `category` | `FeedbackCategory!` · [FeedbackCategory](/api/enums#feedbackcategory) | | | `location` | `String` | | | `description` | `String!` | | | `createdAt` | `Date!` | | ## Subscription health monitoring [#subscription-health-monitoring] ### SubscriptionHealth [#subscriptionhealth] | Field | Type | Description | | --------- | -------------------------------------------------------------------------------- | ----------- | | `status` | `HealthStatus!` · [HealthStatus](/api/enums#healthstatus) | | | `metrics` | `SubscriptionMetrics!` · [SubscriptionMetrics](/api/objects#subscriptionmetrics) | | | `alerts` | `[String!]!` | | ### SubscriptionMetrics [#subscriptionmetrics] | Field | Type | Description | | --------------------------- | ----------------------------------------------------------------------------- | ----------- | | `activeSubscriptions` | `Int!` | | | `totalSubscriptionsCreated` | `Int!` | | | `totalSubscriptionsClosed` | `Int!` | | | `totalEventsEmitted` | `Int!` | | | `lastEventTimestamp` | `Date` | | | `errors` | `[SubscriptionError!]!` · [SubscriptionError](/api/objects#subscriptionerror) | | ### SubscriptionError [#subscriptionerror] | Field | Type | Description | | -------------- | --------- | ----------- | | `timestamp` | `Date!` | | | `error` | `String!` | | | `deploymentId` | `String` | | ## Agent chat system [#agent-chat-system] ### Agent [#agent] | Field | Type | Description | | -------------- | ------------------------------------------------------ | ------------------- | | `id` | `ID!` | | | `name` | `String!` | | | `slug` | `String!` | | | `description` | `String` | | | `avatar` | `String` | | | `systemPrompt` | `String` | | | `model` | `String!` | | | `status` | `AgentStatus!` · [AgentStatus](/api/enums#agentstatus) | | | `userId` | `ID!` | | | `user` | `User!` · [User](/api/objects#user) | | | `chats` | `[Chat!]!` · [Chat](/api/objects#chat) | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | | † | | Some fields omitted | ### Chat [#chat] | Field | Type | Description | | --------------- | ----------------------------------------------- | ----------- | | `id` | `ID!` | | | `title` | `String` | | | `userId` | `ID!` | | | `user` | `User!` · [User](/api/objects#user) | | | `agentId` | `ID!` | | | `agent` | `Agent!` · [Agent](/api/objects#agent) | | | `messages` | `[Message!]!` · [Message](/api/objects#message) | | | `lastMessageAt` | `Date` | | | `metadata` | `JSON` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### Message [#message] | Field | Type | Description | | ------------- | -------------------------------------------------------- | ----------- | | `id` | `ID!` | | | `content` | `String!` | | | `role` | `MessageRole!` · [MessageRole](/api/enums#messagerole) | | | `chatId` | `ID!` | | | `chat` | `Chat!` · [Chat](/api/objects#chat) | | | `userId` | `ID` | | | `user` | `User` · [User](/api/objects#user) | | | `agentId` | `ID` | | | `agent` | `Agent` · [Agent](/api/objects#agent) | | | `attachments` | `[Attachment!]!` · [Attachment](/api/objects#attachment) | | | `metadata` | `JSON` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### Attachment [#attachment] | Field | Type | Description | | ------------- | --------- | ------------------- | | `id` | `ID!` | | | `filename` | `String!` | | | `contentType` | `String!` | | | `size` | `Int!` | | | `url` | `String!` | | | `cid` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | | † | | Some fields omitted | ## Observability / APM [#observability--apm] ### Span [#span] | Field | Type | Description | | -------------------- | ----------------------------------------------------- | ----------- | | `timestamp` | `Date!` | | | `traceId` | `String!` | | | `spanId` | `String!` | | | `parentSpanId` | `String` | | | `traceState` | `String` | | | `spanName` | `String!` | | | `spanKind` | `String!` | | | `serviceName` | `String!` | | | `resourceAttributes` | `JSON` | | | `scopeName` | `String` | | | `scopeVersion` | `String` | | | `spanAttributes` | `JSON` | | | `durationNs` | `String!` | | | `durationMs` | `Float!` | | | `statusCode` | `String!` | | | `statusMessage` | `String` | | | `events` | `[SpanEvent!]!` · [SpanEvent](/api/objects#spanevent) | | | `links` | `[SpanLink!]!` · [SpanLink](/api/objects#spanlink) | | ### SpanEvent [#spanevent] | Field | Type | Description | | ------------ | --------- | ----------- | | `timestamp` | `Date!` | | | `name` | `String!` | | | `attributes` | `JSON` | | ### SpanLink [#spanlink] | Field | Type | Description | | ------------ | --------- | ----------- | | `traceId` | `String!` | | | `spanId` | `String!` | | | `traceState` | `String` | | | `attributes` | `JSON` | | ### Trace [#trace] | Field | Type | Description | | ------------- | -------------------------------------- | ----------- | | `traceId` | `String!` | | | `rootSpan` | `Span` · [Span](/api/objects#span) | | | `spans` | `[Span!]!` · [Span](/api/objects#span) | | | `serviceName` | `String!` | | | `startTime` | `Date!` | | | `endTime` | `Date!` | | | `durationMs` | `Float!` | | | `spanCount` | `Int!` | | | `hasError` | `Boolean!` | | ### MetricDataPoint [#metricdatapoint] | Field | Type | Description | | ----------------------- | ---------- | ----------- | | `timestamp` | `Date!` | | | `metricName` | `String!` | | | `metricDescription` | `String` | | | `metricUnit` | `String` | | | `metricType` | `String!` | | | `value` | `Float` | | | `histogramCount` | `Int` | | | `histogramSum` | `Float` | | | `histogramBuckets` | `[Float!]` | | | `histogramBucketCounts` | `[Int!]` | | | `attributes` | `JSON` | | | `resourceAttributes` | `JSON` | | ### MetricSeries [#metricseries] | Field | Type | Description | | ------------ | ----------------------------------------------------------------------- | ----------- | | `metricName` | `String!` | | | `metricUnit` | `String` | | | `metricType` | `String!` | | | `dataPoints` | `[MetricDataPoint!]!` · [MetricDataPoint](/api/objects#metricdatapoint) | | ### LogEntry [#logentry] | Field | Type | Description | | -------------------- | --------- | ----------- | | `timestamp` | `Date!` | | | `traceId` | `String` | | | `spanId` | `String` | | | `severityText` | `String!` | | | `severityNumber` | `Int!` | | | `body` | `String!` | | | `resourceAttributes` | `JSON` | | | `logAttributes` | `JSON` | | ### ServiceStats [#servicestats] | Field | Type | Description | | --------------- | --------- | ----------- | | `serviceName` | `String!` | | | `spanCount` | `Int!` | | | `traceCount` | `Int!` | | | `errorCount` | `Int!` | | | `errorRate` | `Float!` | | | `avgDurationMs` | `Float!` | | | `p50DurationMs` | `Float!` | | | `p95DurationMs` | `Float!` | | | `p99DurationMs` | `Float!` | | ### ObservabilitySettings [#observabilitysettings] | Field | Type | Description | | ----------------- | ---------- | ----------- | | `id` | `ID!` | | | `projectId` | `String!` | | | `tracesEnabled` | `Boolean!` | | | `metricsEnabled` | `Boolean!` | | | `logsEnabled` | `Boolean!` | | | `traceRetention` | `Int!` | | | `metricRetention` | `Int!` | | | `logRetention` | `Int!` | | | `sampleRate` | `Float!` | | | `maxBytesPerHour` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### TelemetryUsageSummary [#telemetryusagesummary] | Field | Type | Description | | ---------------- | --------- | ----------- | | `projectId` | `String!` | | | `bytesIngested` | `String!` | | | `bytesFormatted` | `String!` | | | `spansCount` | `Int!` | | | `metricsCount` | `Int!` | | | `logsCount` | `Int!` | | | `costCents` | `Int!` | | | `costFormatted` | `String!` | | | `periodStart` | `Date!` | | | `periodEnd` | `Date!` | | ## Templates [#templates] ### TemplateEnvVar [#templateenvvar] | Field | Type | Description | | ------------------ | ---------- | ----------- | | `key` | `String!` | | | `default` | `String` | | | `description` | `String!` | | | `required` | `Boolean!` | | | `secret` | `Boolean` | | | `platformInjected` | `String` | | ### TemplateGpu [#templategpu] | Field | Type | Description | | -------- | --------- | ----------- | | `units` | `Int!` | | | `vendor` | `String!` | | | `model` | `String` | | ### TemplateResources [#templateresources] | Field | Type | Description | | --------- | ------------------------------------------------------- | ----------- | | `cpu` | `Float!` | | | `memory` | `String!` | | | `storage` | `String!` | | | `gpu` | `TemplateGpu` · [TemplateGpu](/api/objects#templategpu) | | ### TemplatePort [#templateport] | Field | Type | Description | | -------- | ---------- | ----------- | | `port` | `Int!` | | | `as` | `Int!` | | | `global` | `Boolean!` | | ### TemplateHealthCheck [#templatehealthcheck] | Field | Type | Description | | ------ | --------- | ----------- | | `path` | `String!` | | | `port` | `Int!` | | ### TemplatePersistentStorage [#templatepersistentstorage] | Field | Type | Description | | ----------- | --------- | ----------- | | `name` | `String!` | | | `size` | `String!` | | | `mountPath` | `String!` | | ### TemplateComponent [#templatecomponent] | Field | Type | Description | | ------------------ | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | `id` | `String!` | | | `name` | `String!` | | | `description` | `String` | | | `primary` | `Boolean` | | | `templateId` | `String` | | | `internalOnly` | `Boolean` | | | `sdlServiceName` | `String` | | | `required` | `Boolean` | Whether this component must be deployed (default true). Primary and internalOnly are always required. | | `fallbacks` | `JSON` | JSON-encoded fallback values when this component is disabled. | | `defaultResources` | `TemplateResources` · [TemplateResources](/api/objects#templateresources) | Resolved default resources for this component (from parent or referenced template). | ### Template [#template] | Field | Type | Description | | ------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `ID!` | | | `name` | `String!` | | | `description` | `String!` | | | `featured` | `Boolean` | | | `releaseStage` | `TemplateReleaseStage!` · [TemplateReleaseStage](/api/enums#templatereleasestage) | | | `category` | `TemplateCategory!` · [TemplateCategory](/api/enums#templatecategory) | | | `tags` | `[String!]!` | | | `icon` | `String` | | | `repoUrl` | `String!` | | | `dockerImage` | `String!` | | | `requiresTee` | `Boolean!` | True when the template only runs on confidential compute (TEE): deploys to non-TEE providers are refused server-side (TEMPLATE\_REQUIRES\_TEE). The UI preselects the Confidential compute mode for these. | | `serviceType` | `String!` | | | `envVars` | `[TemplateEnvVar!]!` · [TemplateEnvVar](/api/objects#templateenvvar) | | | `resources` | `TemplateResources!` · [TemplateResources](/api/objects#templateresources) | | | `ports` | `[TemplatePort!]!` · [TemplatePort](/api/objects#templateport) | | | `healthCheck` | `TemplateHealthCheck` · [TemplateHealthCheck](/api/objects#templatehealthcheck) | | | `persistentStorage` | `[TemplatePersistentStorage!]` · [TemplatePersistentStorage](/api/objects#templatepersistentstorage) | | | `pricingUakt` | `Int` | | | `components` | `[TemplateComponent!]` · [TemplateComponent](/api/objects#templatecomponent) | | ### CompositeDeploymentResult [#compositedeploymentresult] | Field | Type | Description | | --------------------- | ---------------------------------------------------------------------------------------- | ----------- | | `primaryServiceId` | `ID!` | | | `partialSuccess` | `Boolean` | | | `failedComponents` | `[FailedComponentResult!]` · [FailedComponentResult](/api/objects#failedcomponentresult) | | | `succeededComponents` | `[String!]` | | ### FailedComponentResult [#failedcomponentresult] | Field | Type | Description | | --------------- | --------- | ----------- | | `componentId` | `String!` | | | `componentName` | `String!` | | | `error` | `String!` | | ## Queries [#queries] ### OrgBillingRunway [#orgbillingrunway] | Field | Type | Description | | --------------------- | --------- | ----------- | | `balanceCents` | `Int!` | | | `totalDailyBurnCents` | `Int!` | | | `runwayHours` | `Float` | | | `runwayFormatted` | `String!` | | ## Github deploy (phase: github deploy, 2026-04-20) [#github-deploy-phase-github-deploy-2026-04-20] ### GithubInstallation [#githubinstallation] | Field | Type | Description | | ---------------- | --------- | --------------------------------------------------------------------------------- | | `id` | `ID!` | | | `organizationId` | `ID` | Legacy/original AF owner. Access control also uses github\_installation\_access. | | `installationId` | `String!` | GitHub-side numeric installation id (returned as String to avoid Int32 overflow). | | `accountLogin` | `String!` | | | `accountId` | `String!` | | | `accountType` | `String!` | | | `targetType` | `String!` | | | `suspendedAt` | `Date` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ### GithubRepoSummary [#githubreposummary] | Field | Type | Description | | --------------- | ---------- | ----------- | | `id` | `ID!` | | | `name` | `String!` | | | `fullName` | `String!` | | | `owner` | `String!` | | | `private` | `Boolean!` | | | `defaultBranch` | `String!` | | | `description` | `String` | | | `pushedAt` | `String` | | | `language` | `String` | | | `htmlUrl` | `String!` | | ### GithubBranchSummary [#githubbranchsummary] | Field | Type | Description | | ----------- | ---------- | ----------- | | `name` | `String!` | | | `sha` | `String!` | | | `protected` | `Boolean!` | | ### GithubInstallationClaim [#githubinstallationclaim] | Field | Type | Description | | -------------- | --------- | ----------- | | `authorizeUrl` | `String!` | | | `state` | `String!` | | | `expiresAt` | `Date!` | | ### GithubInstallationSyncResult [#githubinstallationsyncresult] | Field | Type | Description | | ---------------- | ----------------------------------------------------------------------------- | ----------- | | `installation` | `GithubInstallation!` · [GithubInstallation](/api/objects#githubinstallation) | | | `organizationId` | `ID!` | | ### BuildJob [#buildjob] | Field | Type | Description | | ------------------- | ------------------------------------------------------ | ----------- | | `id` | `ID!` | | | `serviceId` | `ID!` | | | `commitSha` | `String!` | | | `commitMessage` | `String` | | | `branch` | `String!` | | | `status` | `BuildStatus!` · [BuildStatus](/api/enums#buildstatus) | | | `k8sJobName` | `String` | | | `imageTag` | `String` | | | `detectedFramework` | `String` | | | `detectedPort` | `Int` | | | `logs` | `String` | | | `triggeredBy` | `String` | | | `startedAt` | `Date` | | | `finishedAt` | `Date` | | | `errorMessage` | `String` | | | `createdAt` | `Date!` | | | `updatedAt` | `Date!` | | ## Regions [#regions] ### RegionMedianPrices [#regionmedianprices] Median USD/hr price by GPU model within a region. Computed from the last 24h of GpuBidObservation rows scoped to providers in this region. Null = no recent bid for that model in this region (UI shows ": "). cpu1Core is the median CPU bid (no-GPU probe SDLs) for a tdx.small-equivalent. | Field | Type | Description | | ---------- | ------- | ----------- | | `cpu1Core` | `Float` | | | `h100` | `Float` | | | `h200` | `Float` | | | `rtx4090` | `Float` | | | `a100` | `Float` | | ### Region [#region] A curated region bucket as exposed to the picker UX. The confidential compute (TEE) tier returns a single sentinel row with id=the confidential compute (TEE) tier-single-region: the client detects this and renders the explicit single-region message rather than the picker. | Field | Type | Description | | ---------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `String!` | Stable id: us-east \| us-west \| eu \| asia \| the confidential compute (TEE) tier-single-region (sentinel). | | `label` | `String!` | Human label, e.g. "US East" or "the confidential compute (TEE) tier (single-region)". | | `available` | `Boolean!` | Region availability gate. Default mode (AF\_REGIONS\_REQUIRE\_BIDS unset/0): true iff verifiedCount ≥ 1 (a verified provider exists in the bucket). Strict mode (AF\_REGIONS\_REQUIRE\_BIDS=1): true iff verifiedCount ≥ 1 AND recentBidCount ≥ 1 (a recent bid was observed in the bucket). | | `verifiedCount` | `Int!` | | | `onlineCount` | `Int!` | | | `recentBidCount` | `Int!` | Bid observations from this region in the last 24h. | | `medianPrices` | `RegionMedianPrices!` · [RegionMedianPrices](/api/objects#regionmedianprices) | | | `confidence` | `RegionConfidence!` · [RegionConfidence](/api/enums#regionconfidence) | | ## Scalars [#scalars] | Scalar | Description | | ------ | ----------- | | `Date` | | | `JSON` | | † Some fields, arguments or return types are omitted from this page: provider-specific ones, or ones that belong to retired or admin-only surfaces.