Alternate Futures
API (GraphQL)

Enums

Generated from the API server source (@alternatefutures/backend 0.1.2) on every merge. Endpoint https://api.alternatefutures.ai/graphql, header Authorization: Bearer <personal access token>. See the GraphQL API overview 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.

Service registry (canonical workloads)

ServiceType

ValueDescription
SITE
FUNCTION
VM
DATABASE
CRON
BUCKET

Attestation registry (org-owned allowlist + verified identities)

AttestationRegistryStatus

ValueDescription
ACTIVE
REVOKED

Deployment file access (files tab)

ServiceFileType

ValueDescription
FILE
DIRECTORY
SYMLINK
OTHER

ServiceFileAccessMode

What the user may touch inside the running container. Resolved from the template's fileAccess declaration, falling back to flavor defaults (git-source → READ_ONLY, DATABASE → READ_ONLY, else FULL). Enforced server-side on every file query/mutation: the UI only renders it.

ValueDescription
FULL
CONFIG_ONLY
READ_ONLY
HIDDEN

ServiceShellAccessMode

ValueDescription
FULL
NONE

Feedback & bug reports

FeedbackCategory

ValueDescription
BUG
FEEDBACK
FEATURE_REQUEST

Subscription health monitoring

HealthStatus

ValueDescription
healthy
degraded
unhealthy

Agent chat system

AgentStatus

ValueDescription
ACTIVE
INACTIVE
TRAINING
ERROR

MessageRole

ValueDescription
USER
AGENT
SYSTEM

Observability / APM

MetricAggregation

ValueDescription
AVG
SUM
MIN
MAX
COUNT

Templates

TemplateCategory

ValueDescription
GAME_SERVER
WEB_SERVER
DATABASE
STORAGE
AI_ML
DEVTOOLS
CUSTOM

TemplateReleaseStage

ValueDescription
production
internal

Github deploy (phase: github deploy, 2026-04-20)

BuildStatus

ValueDescription
PENDING
DISPATCH_UNKNOWN
RUNNING
SUCCEEDED
FAILED
CANCELED

Regions

RegionConfidence

Coarse confidence indicator for a region: drives UI dot color.

ValueDescription
GREEN
YELLOW
RED

On this page