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.

Other

identities

Argument	Type	Description
`projectId`	`ID!`
`subjectType`	`IdentitySubjectType` · IdentitySubjectType
`status`	`IdentityLifecycleStatus` · IdentityLifecycleStatus

Returns [IdentityPrincipal!]! · IdentityPrincipal.

identity

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

Returns IdentityPrincipal · IdentityPrincipal.

identityCards

Argument	Type	Description
`projectId`	`ID!`
`subjectDid`	`String`
`status`	`CredentialLifecycleStatus` · CredentialLifecycleStatus

Returns [IdentityCredential!]! · IdentityCredential.

identityVerificationPolicy

Argument	Type	Description
`projectId`	`ID!`
`subjectType`	`IdentitySubjectType!` · IdentitySubjectType

Returns IdentityVerificationPolicy · IdentityVerificationPolicy.

proofProviders

Returns [ProofProvider!]! · ProofProvider.

agentIamBinding

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

Returns A2aAgentBinding · A2aAgentBinding.

Swarm runtime (distinct from the agent chat resource below)

swarmRun

Argument	Type	Description
`id`	`ID!`

Returns SwarmRuntimeRun! · SwarmRuntimeRun.

swarmRuns

Runs of a project, newest first; serviceId narrows to the runs of one runtime service (the web Runs tab).

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

Returns [SwarmRuntimeRun!]! · SwarmRuntimeRun.

swarmRunEvents

Argument	Type	Description
`id`	`ID!`

Returns [SwarmRuntimeEvent!]! · SwarmRuntimeEvent.

swarmDeployment

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

Returns SwarmDeployment! · SwarmDeployment.

swarmDeployProgress

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

Returns SwarmDeployProgress · SwarmDeployProgress.

swarmDefinitionVersions

Registered definition versions of one swarm, newest first (metadata only; bundles never leave the API).

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String!`
`limit`	`Int`

Returns [SwarmDefinitionVersion!]! · SwarmDefinitionVersion.

swarmDefinitionSpec

The authored spec of one registered version (the newest when versionId is omitted); see SwarmDefinitionSpec.

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String!`
`versionId`	`ID`

Returns SwarmDefinitionSpec! · SwarmDefinitionSpec.

swarmModels

Models swarm agents may use. With projectId: that org's list (service-auth's defaults plus the org's Agents toggles under Org › Models); without: the platform defaults.

Argument	Type	Description
`projectId`	`ID`

Returns [SwarmModel!]! · SwarmModel.

swarmRoster

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

Returns SwarmRoster! · SwarmRoster.

swarmRoom

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

Returns SwarmRoom! · SwarmRoom.

swarmRoomSecrets

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

Returns SwarmRoomSecrets! · SwarmRoomSecrets.

swarmDiscord

The swarm's Discord connection (bot identity, channel map, redeploy state); never the token.

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

Returns SwarmDiscordConnection! · SwarmDiscordConnection.

swarmDiscordSecrets

Bridge credential only: the bot token the swarm's sidecar logs in with.

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

Returns SwarmDiscordSecrets! · SwarmDiscordSecrets.

swarmDeploymentLogs

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String!`
`tail`	`Int`

Returns SwarmDeploymentLogs! · SwarmDeploymentLogs.

runtimeWatch

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

Returns RuntimeWatchSnapshot! · RuntimeWatchSnapshot.

runtimeTrace

Argument	Type	Description
`runId`	`ID!`

Returns RuntimeTrace! · RuntimeTrace.

runtimeStateHistory

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String`
`agentId`	`String!`
`after`	`String`
`limit`	`Int!`

Returns RuntimeStateHistory! · RuntimeStateHistory.

runtimeStateAtVersion

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String`
`agentId`	`String!`
`version`	`String!`

Returns JSON!.

exportRuntimeAgent

Argument	Type	Description
`projectId`	`ID!`
`swarmId`	`String`
`agentId`	`String!`
`format`	`RuntimeAgentExportFormat!` · RuntimeAgentExportFormat

Returns RuntimeAgentExport! · RuntimeAgentExport.

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.

service

One service by id (project access required). Use for on-demand fields such as spend.

Argument	Type	Description
`id`	`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