Mutations
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.
Auth - SDK token exchange
loginWithPersonalAccessToken
Exchange a Personal Access Token for a short-lived access token. Used by the SDK to authenticate subsequent requests.
| Argument | Type | Description |
|---|---|---|
data | LoginWithPersonalAccessTokenDataInput! · LoginWithPersonalAccessTokenDataInput |
Returns String!.
Auth
createPersonalAccessToken
| Argument | Type | Description |
|---|---|---|
name | String! | |
expiresAt | Date |
Returns PersonalAccessTokenCreated! · PersonalAccessTokenCreated.
deletePersonalAccessToken
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
Projects
createProject
| Argument | Type | Description |
|---|---|---|
data | CreateProjectDataInput! · CreateProjectDataInput |
Returns Project! · Project.
updateProject
| Argument | Type | Description |
|---|---|---|
id | ID! | |
data | UpdateProjectDataInput! · UpdateProjectDataInput |
Returns Project! · Project.
deleteProject
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
projectChatSession
Mint a single-use join ticket (plus room id, relay URL and room secret) for a project's chat. Requires project access; organization projects only. Relay-blind, not end-to-end: the platform can read project chat.
| Argument | Type | Description |
|---|---|---|
projectId | ID! |
Returns ProjectChatSession! · ProjectChatSession.
publicChatTicket
Mint a single-use join ticket for the hosted public chat. Requires only an authenticated caller: no org or project check. The ticket is NOT bound to a room: the platform never learns which public rooms exist or who is in them, only that this user opened chat.
Returns PublicChatTicket! · PublicChatTicket.
Services
createService
| Argument | Type | Description |
|---|---|---|
input | CreateServiceInput! · CreateServiceInput |
Returns Service! · Service.
updateService
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
input | UpdateServiceInput! · UpdateServiceInput |
Returns Service! · Service.
updateServicePriority
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
shutdownPriority | Int! |
Returns Service! · Service.
deleteService
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Service! · Service.
Attestation registry (org allowlist; AF hosts, org authors)
addAttestationMeasurement
Bless a build measurement (compose_hash) in the active org's allowlist.
| Argument | Type | Description |
|---|---|---|
input | AddAttestationMeasurementInput! · AddAttestationMeasurementInput |
Returns AttestationMeasurement! · AttestationMeasurement.
revokeAttestationMeasurement
Revoke a blessed measurement. Idempotent; revocation retires every identity minted from it.
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns AttestationMeasurement! · AttestationMeasurement.
registerAttestedIdentity
Verify a server's quote (Intel DCAP roots, in-process) and record its identity. Requires the quote's measurement to be ACTIVE in the active org's allowlist and the quote's report_data to bind the pubkey.
| Argument | Type | Description |
|---|---|---|
input | RegisterAttestedIdentityInput! · RegisterAttestedIdentityInput |
Returns AttestedIdentity! · AttestedIdentity.
Agent chat
createAgent
| Argument | Type | Description |
|---|---|---|
input | CreateAgentInput! · CreateAgentInput |
Returns Agent! · Agent.
createChat
| Argument | Type | Description |
|---|---|---|
input | CreateChatInput! · CreateChatInput |
Returns Chat! · Chat.
sendMessage
| Argument | Type | Description |
|---|---|---|
input | SendMessageInput! · SendMessageInput |
Returns Message! · Message.
deleteChat
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
Observability settings
updateObservabilitySettings
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
input | UpdateObservabilitySettingsInput! · UpdateObservabilitySettingsInput |
Returns ObservabilitySettings! · ObservabilitySettings.
Templates
deployFromTemplate
| Argument | Type | Description |
|---|---|---|
input | DeployFromTemplateInput! · DeployFromTemplateInput |
Returns a deployment object for the service's compute tier (provider-specific, not documented here). †
deployCompositeTemplate
| Argument | Type | Description |
|---|---|---|
input | DeployCompositeTemplateInput! · DeployCompositeTemplateInput |
Returns CompositeDeploymentResult! · CompositeDeploymentResult.
Service environment variables
setServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! | |
value | String! | |
secret | Boolean |
Returns ServiceEnvVar! · ServiceEnvVar.
deleteServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! |
Returns Boolean!.
bulkSetServiceEnvVars
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
vars | [EnvVarInput!]! · EnvVarInput |
Returns [ServiceEnvVar!]! · ServiceEnvVar.
revealServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! |
Returns String!.
Service port configuration
setServicePort
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
containerPort | Int! | |
publicPort | Int | |
protocol | String |
Returns ServicePort! · ServicePort.
deleteServicePort
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
containerPort | Int! |
Returns Boolean!.
Service linking
linkServices
| Argument | Type | Description |
|---|---|---|
sourceServiceId | ID! | |
targetServiceId | ID! | |
alias | String |
Returns ServiceLink! · ServiceLink.
unlinkServices
| Argument | Type | Description |
|---|---|---|
sourceServiceId | ID! | |
targetServiceId | ID! |
Returns Boolean!.
Deployment file access (files tab)
writeServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! | |
content | String! |
Returns ServiceFileWriteResult! · ServiceFileWriteResult.
createServiceDirectory
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! |
Returns Boolean!.
renameServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
fromPath | String! | |
toPath | String! |
Returns Boolean!.
deleteServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! |
Returns Boolean!.
Feedback
submitFeedback
| Argument | Type | Description |
|---|---|---|
input | SubmitFeedbackInput! · SubmitFeedbackInput |
Returns FeedbackReport! · FeedbackReport.
GitHub deploy
beginGithubInstallationClaim
Begin a one-use GitHub user-authorization proof bound to the caller, AF organization, and exact installation id returned by GitHub's setup URL.
| Argument | Type | Description |
|---|---|---|
installationId | String! | |
orgId | ID |
Returns GithubInstallationClaim! · GithubInstallationClaim.
syncGithubInstallation
Create or grant an installation only after exchanging a GitHub user OAuth code and proving that user can access the exact App installation.
| Argument | Type | Description |
|---|---|---|
state | String! | |
code | String! |
Returns GithubInstallationSyncResult! · GithubInstallationSyncResult.
refreshGithubInstallations
Live-pull all accessible App installations from GitHub into the local DB and return them. Slow path: UI uses this only on explicit Refresh / post-install.
| Argument | Type | Description |
|---|---|---|
orgId | ID |
Returns [GithubInstallation!]! · GithubInstallation.
uninstallGithubInstallation
Remove only this AF organization's installation grant and detach its services. GitHub-wide uninstall remains an installation-admin action on github.com and is reconciled by the signed deletion webhook.
| Argument | Type | Description |
|---|---|---|
installationId | ID! | |
orgId | ID |
Returns Boolean!.
createGithubService
| Argument | Type | Description |
|---|---|---|
input | CreateGithubServiceInput! · CreateGithubServiceInput |
Returns Service! · Service.
connectGithubRepo
| Argument | Type | Description |
|---|---|---|
input | ConnectGithubRepoInput! · ConnectGithubRepoInput |
Returns Service! · Service.
redeployGithubService
Trigger a new build. With no sha, builds the tip of the tracked branch (default behaviour, used by top-level Rebuild). With a sha (7-40 char hex commit SHA), rebuilds that exact commit: used by the per-row rebuild button in build history.
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
sha | String |
Returns BuildJob! · BuildJob.
† Some fields, arguments or return types are omitted from this page: provider-specific ones, or ones that belong to retired or admin-only surfaces.