Queries

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.

Version

version

Returns Version! · Version.

Templates

templates

Argument	Type	Description
`category`	`TemplateCategory` · TemplateCategory

Returns [Template!]! · Template.

template

Argument	Type	Description
`id`	`ID!`

Returns Template · Template.

User & auth

me

Returns User · User.

personalAccessTokens

Returns PersonalAccessTokenList! · PersonalAccessTokenList.

apiKeyRateLimit

Returns ApiKeyRateLimit! · ApiKeyRateLimit.

Projects

project

Argument	Type	Description
`id`	`ID!`

Returns Project · Project.

resolveProject

Resolve an accessible project by exact ID, name, or slug; ambiguous names/slugs fail closed.

Argument	Type	Description
`ref`	`String!`

Returns Project · Project.

projects

Returns ProjectList! · ProjectList.

Service registry

serviceRegistry

Argument	Type	Description
`projectId`	`ID`

Returns [Service!]! · Service.

Workspace metrics (aggregated compute, storage, traffic)

workspaceMetrics

Argument	Type	Description
`projectId`	`ID`

Returns WorkspaceMetrics! · WorkspaceMetrics.

Unified deployments (all deployment types across all services)

allDeployments

Argument	Type	Description
`projectId`	`ID`
`limit`	`Int`

Returns [UnifiedDeployment!]! · UnifiedDeployment.

System health

subscriptionHealth

Returns SubscriptionHealth! · SubscriptionHealth.

Agent chat

agent

Argument	Type	Description
`id`	`ID!`

Returns Agent · Agent.

agentBySlug

Argument	Type	Description
`slug`	`String!`

Returns Agent · Agent.

agents

Returns [Agent!]! · Agent.

chat

Argument	Type	Description
`id`	`ID!`

Returns Chat · Chat.

chats

Returns [Chat!]! · Chat.

messages

Argument	Type	Description
`chatId`	`ID!`
`limit`	`Int`
`before`	`String`

Returns [Message!]! · Message.

Observability / APM

traces

Argument	Type	Description
`input`	`TraceQueryInput!` · TraceQueryInput

Returns [Trace!]! · Trace.

trace

Argument	Type	Description
`projectId`	`ID!`
`traceId`	`String!`

Returns Trace · Trace.

metrics

Argument	Type	Description
`input`	`MetricQueryInput!` · MetricQueryInput

Returns [MetricSeries!]! · MetricSeries.

logs

Argument	Type	Description
`input`	`LogQueryInput!` · LogQueryInput

Returns [LogEntry!]! · LogEntry.

services

Argument	Type	Description
`projectId`	`ID!`
`startTime`	`Date!`
`endTime`	`Date!`

Returns [ServiceStats!]! · ServiceStats.

observabilitySettings

Argument	Type	Description
`projectId`	`ID!`

Returns ObservabilitySettings · ObservabilitySettings.

telemetryUsage

Argument	Type	Description
`projectId`	`ID!`
`startDate`	`Date!`
`endDate`	`Date!`

Returns TelemetryUsageSummary! · TelemetryUsageSummary.

Live container health from provider

deploymentHealth

Argument	Type	Description
`serviceId`	`ID!`

Returns DeploymentHealth · DeploymentHealth.

Service container logs

serviceLogs

Argument	Type	Description
`serviceId`	`ID!`
`tail`	`Int`
`service`	`String`

Returns ServiceLogResult! · ServiceLogResult.

attestationMeasurements

The active organization's attestation measurement allowlist.

Returns [AttestationMeasurement!]! · AttestationMeasurement.

serviceAttestedIdentities

Registry identities linked to this service, newest first. status is the EFFECTIVE status (a revoked measurement retires its identities): the same verdict the public REST lookup serves.

Argument	Type	Description
`serviceId`	`ID!`

Returns [AttestedIdentity!]! · AttestedIdentity.

Deployment file access (files tab)

serviceFiles

Argument	Type	Description
`serviceId`	`ID!`
`path`	`String!`

Returns ServiceFileList! · ServiceFileList.

serviceFileContent

Argument	Type	Description
`serviceId`	`ID!`
`path`	`String!`

Returns ServiceFileContent! · ServiceFileContent.

serviceFileAccessPolicy

Argument	Type	Description
`serviceId`	`ID!`

Returns ServiceFileAccessPolicy! · ServiceFileAccessPolicy.

Service links (connections between services)

serviceLinks

Argument	Type	Description
`projectId`	`ID!`

Returns [ServiceLink!]! · ServiceLink.

Org billing runway (how long until funds run out)

orgBillingRunway

Returns OrgBillingRunway · OrgBillingRunway.

GitHub deploy

githubAppEnabled

Returns Boolean!.

githubAppSlug

Returns String.

githubInstallations

Argument	Type	Description
`orgId`	`ID`

Returns [GithubInstallation!]! · GithubInstallation.

githubInstallationRepos

Argument	Type	Description
`installationId`	`ID!`

Returns [GithubRepoSummary!]! · GithubRepoSummary.

githubRepoBranches

Argument	Type	Description
`installationId`	`ID!`
`owner`	`String!`
`repo`	`String!`

Returns [GithubBranchSummary!]! · GithubBranchSummary.

Builds

buildJob

Fetch a single BuildJob by id (auth: caller must have access to the parent service's project). Used by the Source-tab build-history UI to lazy-load the logs blob on row expand.

Argument	Type	Description
`id`	`ID!`

Returns BuildJob · BuildJob.

serviceBuildJobs

List recent BuildJobs for a service, newest first. Logs blob omitted: fetch it via buildJob(id) on demand. Used by the Source-tab build-history list (polled every 3s while a build is in flight).

Argument	Type	Description
`serviceId`	`ID!`
`limit`	`Int`

Returns [BuildJob!]! · BuildJob.

Regions

regions

Return curated region buckets with live availability + pricing for the picker. Defaults to the standard compute tier when provider is omitted. The gpuModelHint argument is reserved for future per-model price emphasis; ignored today.

Argument	Type	Description
`gpuModelHint`	`String`

Some arguments are omitted. †

Returns [Region!]! · Region.

† Some fields, arguments or return types are omitted from this page: provider-specific ones, or ones that belong to retired or admin-only surfaces.

On this page