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
| Value | Description |
|---|---|
SITE | |
FUNCTION | |
VM | |
DATABASE | |
CRON | |
BUCKET |
Attestation registry (org-owned allowlist + verified identities)
AttestationRegistryStatus
| Value | Description |
|---|---|
ACTIVE | |
REVOKED |
Deployment file access (files tab)
ServiceFileType
| Value | Description |
|---|---|
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.
| Value | Description |
|---|---|
FULL | |
CONFIG_ONLY | |
READ_ONLY | |
HIDDEN |
ServiceShellAccessMode
| Value | Description |
|---|---|
FULL | |
NONE |
Feedback & bug reports
FeedbackCategory
| Value | Description |
|---|---|
BUG | |
FEEDBACK | |
FEATURE_REQUEST |
Subscription health monitoring
HealthStatus
| Value | Description |
|---|---|
healthy | |
degraded | |
unhealthy |
Agent chat system
AgentStatus
| Value | Description |
|---|---|
ACTIVE | |
INACTIVE | |
TRAINING | |
ERROR |
MessageRole
| Value | Description |
|---|---|
USER | |
AGENT | |
SYSTEM |
Observability / APM
MetricAggregation
| Value | Description |
|---|---|
AVG | |
SUM | |
MIN | |
MAX | |
COUNT |
Templates
TemplateCategory
| Value | Description |
|---|---|
GAME_SERVER | |
WEB_SERVER | |
DATABASE | |
STORAGE | |
AI_ML | |
DEVTOOLS | |
CUSTOM |
TemplateReleaseStage
| Value | Description |
|---|---|
production | |
internal |
SwarmRuntimeRunStatus
| Value | Description |
|---|---|
SUBMITTING | |
QUEUED | |
AWAITING_INPUT | |
SUCCEEDED | |
FAILED | |
CANCELLED | |
DISPATCH_UNKNOWN |
SwarmRuntimeApprovalAction
| Value | Description |
|---|---|
APPROVE | |
EDIT | |
REJECT | |
RESPOND |
RuntimeAgentAction
| Value | Description |
|---|---|
FREEZE | |
HYDRATE |
RuntimeAgentExportFormat
| Value | Description |
|---|---|
AF | |
JSON |
IdentitySubjectType
| Value | Description |
|---|---|
HUMAN | |
AGENT |
IdentityLifecycleStatus
| Value | Description |
|---|---|
ACTIVE | |
DEACTIVATED |
CredentialLifecycleStatus
| Value | Description |
|---|---|
ACTIVE | |
REVOKED | |
SUSPENDED |
Github deploy (phase: github deploy, 2026-04-20)
BuildStatus
| Value | Description |
|---|---|
PENDING | |
DISPATCH_UNKNOWN | |
RUNNING | |
SUCCEEDED | |
FAILED | |
CANCELED |
Regions
RegionConfidence
Coarse confidence indicator for a region: drives UI dot color.
| Value | Description |
|---|---|
GREEN | |
YELLOW | |
RED |
Input types
The input object types accepted by Alternate Clouds GraphQL queries and mutations, grouped by area, generated from the API source.
AI tools and automation
How AI agents and LLM tools should read these docs and operate Alternate Clouds: llms.txt, Markdown endpoints, the Copy for AI button, the agent plugin, and the non-interactive CLI contract.